oci_new_connect - Устанавливает новое соединение с сервером Oracle
Вернуться к: OCI8 Функции
oci_new_connect
(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)
oci_new_connect — Устанавливает новое соединение с сервером Oracle
Описание
$username
, string $password
[, string $connection_string
[, string $character_set
[, int $session_mode
]]] )Создает новое соединение с сервером Oracle и выполняет вход.
В отличие от oci_connect() и oci_pconnect(), функция oci_new_connect() не кэширует соединения и при каждом вызове устанавливает новое соединение. Это полезно, если приложению необходима транзакционная изоляция двух наборов запросов.
Список параметров
-
username -
Имя пользователя Oracle.
-
password -
Пароль пользователя
username. -
connection_string -
Содержит экземпляр 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 был читаемым. Убедитесь, что веб-сервер имеет доступ к этому файлу.
-
character_set -
Определяет кодировку, используемую клиентскими библиотеками 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_new_connect()
<?php
// создайте таблицу mytab (mycol number);
function query($name, $c)
{
echo "Выполнение $name\n";
$s = oci_parse($c, "select * from mytab");
oci_execute($s, OCI_NO_AUTO_COMMIT);
$row = oci_fetch_array($s, OCI_ASSOC);
if (!$row) {
echo "Нет данных\n";
} else {
do {
foreach ($row as $item)
echo $item . " ";
echo "\n";
} while (($row = oci_fetch_array($s, OCI_ASSOC)) != false);
}
}
$c1 = oci_connect("hr", "welcome", "localhost/orcl");
$c2 = oci_new_connect("hr", "welcome", "localhost/orcl");
$s = oci_parse($c1, "insert into mytab values(1234)");
oci_execute($s, OCI_NO_AUTO_COMMIT);
query("основного соединения", $c1);
query("нового соединения", $c2);
oci_commit($c1);
query("нового соединения после commit", $c2);
// Выведет:
// Выполнение основного соединения
// 1234
// Выполнение нового соединения
// Нет данных
// Выполнение нового соединения после commit
// 1234
?>
Дополнительные примеры можно найти в описании функции oci_connect().
Смотрите также
- oci_connect() - Устанавливает соединение с базой данных Oracle
- oci_pconnect() - Устанавливает постоянное соединение с сервером Oracle
Вернуться к: OCI8 Функции