oci_connect

说明

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

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。

使用 Oracle 服务器 9.2 或更高版本，可以指定 charset 参数，其将被用于新的连接。如果使用 Oracle 服务器低于 9.2 的版本，本参数将被忽略并以 NLS_LANG 环境变量替代之。

例子 1. oci_connect() 例子 <?php echo "<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 c1 insert_data($c2);   // Insert a row using c2 select_data($c1);   // Results of both inserts are returned select_data($c2); rollback($c1);      // Rollback using c1 select_data($c1);   // Both inserts have been rolled back select_data($c2); insert_data($c2);   // Insert a row using c2 commit($c2);        // Commit using c2 select_data($c1);   // Result of c2 insert is returned delete_data($c1);   // Delete all rows in table using c1 select_data($c1);   // No rows returned select_data($c2);   // No rows returned commit($c1);        // Commit using c1 select_data($c1);   // No rows returned select_data($c2);   // No rows returned drop_table($c1); echo "</pre>"; ?>

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

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