(PHP 5, 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
echo "<html><pre>";
$db = "";
$c1 = oci_connect("scott", "tiger", $db);
$c2 = oci_new_connect("scott", "tiger", $db);
function create_table($conn)
{
$stmt = oci_parse($conn, "create table scott.hallo (test
varchar2(64))");
oci_execute($stmt);
echo $conn . " created table\n\n";
}
function drop_table($conn)
{
$stmt = oci_parse($conn, "drop table scott.hallo");
oci_execute($stmt);
echo $conn . " dropped table\n\n";
}
function insert_data($conn)
{
$stmt = oci_parse($conn, "insert into scott.hallo
values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))");
oci_execute($stmt, OCI_DEFAULT);
echo $conn . " inserted hallo\n\n";
}
function delete_data($conn)
{
$stmt = oci_parse($conn, "delete from scott.hallo");
oci_execute($stmt, OCI_DEFAULT);
echo $conn . " deleted hallo\n\n";
}
function commit($conn)
{
oci_commit($conn);
echo $conn . " committed\n\n";
}
function rollback($conn)
{
oci_rollback($conn);
echo $conn . " rollback\n\n";
}
function select_data($conn)
{
$stmt = oci_parse($conn, "select * from scott.hallo");
oci_execute($stmt, OCI_DEFAULT);
echo $conn . "----selecting\n\n";
while (oci_fetch($stmt)) {
echo $conn . " <" . oci_result($stmt, "TEST") . ">\n\n";
}
echo $conn . "----done\n\n";
}
create_table($c1);
insert_data($c1);
select_data($c1);
select_data($c2);
rollback($c1);
select_data($c1);
select_data($c2);
insert_data($c2);
commit($c2);
select_data($c1);
delete_data($c1);
select_data($c1);
select_data($c2);
commit($c1);
select_data($c1);
select_data($c2);
drop_table($c1);
echo "</pre></html>";
?>
Замечание:
В версиях PHP ниже 5.0.0 необходимо использовать функцию ocinlogon(). Старое имя функции также может быть использовано в текущих версиях, хотя оно уже устарело и не рекомендуется.