(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)
oci_new_connect — 使用唯一连接连接到 Oracle 服务器
$username,$password,$connection_string = null,$encoding = "",$session_mode = OCI_DEFAULT建立到 Oracle 服务器的新连接并登录。
与 oci_connect() 和 oci_pconnect() 不同，oci_new_connect() 不会缓存连接，并且始终会返回一个全新的、刚打开的连接句柄。如果您的应用程序需要在两组查询之间进行事务隔离，这将非常有用。
用户名Oracle 用户名。
密码username 的密码。
连接字符串包含要连接到的 Oracle 实例。它可以是 » Easy Connect 字符串、来自 tnsnames.ora 文件的连接名称或本地 Oracle 实例的名称。
如果未指定或为 null，则 PHP 使用环境变量（如 Linux 上的 TWO_TASK 或 Windows 上的 LOCAL 和 ORACLE_SID）来确定要连接到的 Oracle 实例。
要使用 Easy Connect 命名方法，PHP 必须与 Oracle 10g 或更高版本的客户端库链接。Oracle 10g 的 Easy Connect 字符串格式为：[//]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。确保 Web 守护程序具有对该文件的读取权限。
编码确定 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 模式组合。
出于安全原因，Windows 上不支持 OCI_CRED_EXT。
返回连接标识符或错误时的 false。
| 版本 | 描述 |
|---|---|
| 8.0.0，PECL OCI8 3.0.0 |
connection_string 现在可以为 null。 |
以下演示了如何分离连接。
示例 #1 oci_new_connect() 示例
<?php
// 创建表 mytab (mycol 数字类型);
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("提交后新的连接", $c2);
// 输出结果为：
// 正在查询基本连接
// 1234
// 正在查询新的连接
// 没有行
// 正在查询提交后新的连接
// 1234
?>请参阅 oci_connect() 以获取参数用法的更多示例。