array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.oci-pconnect.php', 1 => 'oci_pconnect', ), 'up' => array ( 0 => 'ref.oci8.php', 1 => 'OCI8 Функции', ), 'prev' => array ( 0 => 'function.oci-password-change.php', 1 => 'oci_password_change', ), 'next' => array ( 0 => 'function.oci-register-taf-callback.php', 1 => 'oci_register_taf_callback', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/oci8/functions/oci-pconnect.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_pconnect — Устанавливает постоянное соединение с сервером Oracle
$username
,$password
,$connection_string
= null
,$encoding
= "",$session_mode
= OCI_DEFAULT
Создаёт постоянное соединение с сервером Oracle и выполняет аутентификацию.
Постоянные соединения кешируются и повторно используются при следующих запросах, в результате снижаются накладные расходы при каждой загрузке страницы; типичное приложение PHP имеет одно постоянное подключение к серверу PHP, реализованное дочерним процессом Apache (или процессом PHP FPM). Дополнительную информацию смотрите в разделе Работа с соединениями OCI8 и Connection Pooling.
username
Имя пользователя Oracle.
password
Пароль пользователя username
.
connection_string
Содержит
экземпляр Oracle
для подключения. Это может быть
» Easy Connect
string, или Connect Name из файла
tnsnames.ora, или имя локального экземпляра Oracle.
Если не указано отдельно или null
, 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 19c были введены дополнительные параметры, включая настройки времени ожидания и проверки активности.
Обратитесь к документации Oracle. Названия служб могут быть определены с помощью запуска Oracle утилиты lsnrctl status
на сервере базы данных.
Файл tnsnames.ora может находиться в поисковом пути Oracle Net, который включает
/your/path/to/instantclient/network/admin,
$ORACLE_HOME/network/admin и /etc. В качестве альтернативного варианта
можно установить TNS_ADMIN
таким образом, чтобы путь $TNS_ADMIN/tnsnames.ora был читаемым.
Убедитесь, что веб-сервер имеет доступ к этому файлу.
encoding
Определяет кодировку, которую будут использовать клиентские библиотеки Oracle. Эта кодировка не обязательно должна совпадать с кодировкой, используемой в самой базе данных. Если она не совпадает, Oracle сделает всё возможное для конвертирования данных из- и в эту кодировку. В зависимости от используемых кодировок это может не всегда давать приемлемые результаты. Преобразование также создаёт некоторые дополнительные временные затраты.
Если кодировка не указана, клиентские библиотеки Oracle будут определять
её из переменной окружения NLS_LANG
.
Передача этого параметра может уменьшить время затрачиваемое на соединение.
session_mode
Этот параметр доступен
начиная с версии 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
в случае возникновения ошибки.
Пример #1 Простой пример для oci_pconnect() с использованием упрощённого синтаксиса подключения
<?php
// Подключение к XE сервису (т.е. базе данных) на локальной машине
$conn = oci_pconnect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$stid = oci_parse($conn, 'SELECT * FROM employees');
oci_execute($stid);
echo "<table border='1'>\n";
while ($row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_NULLS)) {
echo "<tr>\n";
foreach ($row as $item) {
echo " <td>" . ($item !== null ? htmlentities($item, ENT_QUOTES) : "") . "</td>\n";
}
echo "</tr>\n";
}
echo "</table>\n";
?>
Дополнительные примеры можно найти в описании функции oci_connect().
Замечание: Продолжительность и максимальное количество постоянных соединений к серверу Oracle на каждый процесс PHP может быть изменено в следующих директивах: oci8.persistent_timeout, oci8.ping_interval и oci8.max_persistent.