PHP Manual
OCI8 函数
建立一个到 Oracle 服务器的连接

oci_connect

(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)

oci_connect — 建立一个到 Oracle 服务器的连接

说明

oci_connect ( string $username , string $password [, string $db [, string $charset [, int $session_mode ]]] ) : resource

oci_connect() 返回一个大多数 OCI 调用都需要的连接标识符。可选的第三个参数可以包含想要连接的本地 Oracle 的实例的或者在 tnsnames.ora 中的条目的名字。如果没有指定可选的第三个参数，PHP 使用环境变量 ORACLE_SID（Oracle 实例）或 TWO_TASK（tnsnames.ora）来确定连接哪一个数据库。

session_mode 参数自版本 1.1 起可用并接受如下值：OCI_DEFAULT，OCI_SYSOPER 和 OCI_SYSDBA。如果指定了 OCI_SYSOPER 或 OCI_SYSDBA 其中之一，oci_connect() 将尝试使用外部认证信息建立特权连接。特权连接默认被禁止。要启用，需要将 oci8.privileged_connect 设为 On。

Note:
对 oci_connect() 用同样的参数第二次及之后的调用将返回第一次调用所返回的连接句柄。也就是说对一个句柄发出的查询也适用于另一个句柄，因为它们是同一个句柄。此行为演示于下面的例 1。如果需要两个句柄在事务上互相隔离开，应该使用 oci_new_connect() 来替代。

使用 Oracle 客户端库来确定字符集。字符集不需要与数据库的字符集相匹配。如果不匹配，Oracle 会尽可能地将数据从数据库字符集进行转换。因为依赖于字符集，可能不能给出可用的结果。转换也增加一些时间开销。

如果不指定，Oracle 客户端用 NLS_LANG 环境变量来决定字符集。

传递此参数可减少连接时间。

Example #1 oci_connect() 例子

<?phpecho "<pre>";$db = "";$c1 = oci_connect("scott", "tiger", $db);$c2 = oci_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); // Insert a row using c1insert_data($c2); // Insert a row using c2select_data($c1); // Results of both inserts are returnedselect_data($c2);rollback($c1); // Rollback using c1select_data($c1); // Both inserts have been rolled backselect_data($c2);insert_data($c2); // Insert a row using c2commit($c2); // Commit using c2select_data($c1); // Result of c2 insert is returneddelete_data($c1); // Delete all rows in table using c1select_data($c1); // No rows returnedselect_data($c2); // No rows returnedcommit($c1); // Commit using c1select_data($c1); // No rows returnedselect_data($c2); // No rows returneddrop_table($c1);echo "</pre>";?>

oci_connect() 如果出错则返回 false。

Note:
在 PHP 5.0.0 之前的版本必须使用 ocilogon() 替代本函数。该函数名仍然可用，为向下兼容作为 oci_connect() 的别名。不过其已被废弃，不推荐使用。

参见 oci_pconnect()，oci_new_connect() 和 oci_close()。

参数

username

The Oracle user name.

password

The password for username.

connection_string

包含要连接的 Oracle 实例。可以是 » Easy Connect 串，或是 tnsnames.ora 文件中的连接名，或是本地 Oracle 实例名。

如果不指定，PHP 使用环境变量来确定连接的 Oracle 实例，诸如 TWO_TASK（Linux 下）或 LOCAL（Windows 下）与 ORACLE_SID 等。

要使用 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 加入类更多选项，例如 timeout 和 keep-alive 设置。请参考 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 守护进程可读取此文件。

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 系统。

返回值

Returns a connection identifier or false on error.

范例

Example #2 Basic oci_connect() using Easy Connect syntax

<?php// Connects to the XE service (i.e. database) on the "localhost" machine$conn = oci_connect('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";?>

Example #3 Basic oci_connect() using a Network Connect name

<?php// Connects to the MYDB database described in tnsnames.ora file,// One example tnsnames.ora entry for MYDB could be:// MYDB =// (DESCRIPTION =// (ADDRESS = (PROTOCOL = TCP)(HOST = mymachine.oracle.com)(PORT = 1521))// (CONNECT_DATA =// (SERVER = DEDICATED)// (SERVICE_NAME = XE)// )// )$conn = oci_connect('hr', 'welcome', 'MYDB');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";?>

Example #4 oci_connect() with an explicit character set

<?php$conn = oci_connect('hr', 'welcome', 'localhost/XE', 'AL32UTF8');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";?>

Example #5 Using multiple calls to oci_connect()

<?php$c1 = oci_connect("hr", "welcome", 'localhost/XE');$c2 = oci_connect("hr", "welcome", 'localhost/XE');// Both $c1 and $c2 show the same PHP resource id meaning they use the// same underlying database connectionecho "c1 is $c1<br>\n";echo "c2 is $c2<br>\n";function create_table($conn){ $stmt = oci_parse($conn, "create table hallo (test varchar2(64))"); oci_execute($stmt); echo "Created table<br>\n";}function drop_table($conn){ $stmt = oci_parse($conn, "drop table hallo"); oci_execute($stmt); echo "Dropped table<br>\n";}function insert_data($connname, $conn){ $stmt = oci_parse($conn, "insert into hallo values(to_char(sysdate,'DD-MON-YY HH24:MI:SS'))"); oci_execute($stmt, OCI_DEFAULT); echo "$connname inserted row without committing<br>\n";}function rollback($connname, $conn){ oci_rollback($conn); echo "$connname rollback<br>\n";}function select_data($connname, $conn){ $stmt = oci_parse($conn, "select * from hallo"); oci_execute($stmt, OCI_DEFAULT); echo "$connname ----selecting<br>\n"; while (oci_fetch($stmt)) { echo " " . oci_result($stmt, "TEST") . "<br>\n"; } echo "$connname ----done<br>\n";}create_table($c1);insert_data('c1', $c1); // Insert a row using c1sleep(2); // sleep to show a different timestamp for the 2nd rowinsert_data('c2', $c2); // Insert a row using c2select_data('c1', $c1); // Results of both inserts are returnedselect_data('c2', $c2); // Results of both inserts are returnedrollback('c1', $c1); // Rollback using c1select_data('c1', $c1); // Both inserts have been rolled backselect_data('c2', $c2);drop_table($c1);// Closing one of the connections makes the PHP variable unusable, but// the other could be usedoci_close($c1);echo "c1 is $c1<br>\n";echo "c2 is $c2<br>\n";// Output is:// c1 is Resource id #5// c2 is Resource id #5// Created table// c1 inserted row without committing// c2 inserted row without committing// c1 ----selecting// 09-DEC-09 12:14:43// 09-DEC-09 12:14:45// c1 ----done// c2 ----selecting// 09-DEC-09 12:14:43// 09-DEC-09 12:14:45// c2 ----done// c1 rollback// c1 ----selecting// c1 ----done// c2 ----selecting// c2 ----done// Dropped table// c1 is // c2 is Resource id #5?>

注释

Note:
An incorrectly installed or configured OCI8 extension will often manifest itself as a connection problem or error. See Installing/Configuring for troubleshooting information.

Note:
In PHP versions before 5.0.0 use ocilogon() instead.

参见

oci_pconnect() - 使用一个持久连接连到 Oracle 数据库
oci_new_connect() - 建定一个到 Oracle 服务器的新连接
oci_close() - 关闭 Oracle 连接

Php/docs/function.oci-connect

目录

oci_connect

说明

参数

返回值

范例

注释

参见