简介

本类函数使用 Oracle Call Interface（OCI）使用户可以访问 Oracle 10，Oracle9，Oracle8 和 Oracle7 数据库。支持将 PHP 变量与 Oracle 占位符（placeholder）绑定，具有完整的 LOB，FILE 和 ROWID 支持，以及允许使用用户提供的定义变量。

需求

使用本扩展需要 Oracle 客户端库。Windows 用户需要至少 Oracle 8.1 版才能使用 php_oci8.dll。

安装所有所需文件最方便的方法是使用 Oracle Instant Client，可以从此处得到：http://www.oracle.com/technology/tech/oci/instantclient/instantclient.html。Instant Client 不需要 ORACLE_SID 或 ORACLE_HOME 环境变量被设定。不过可能还是要设定 LD_LIBRARY_PATH 和 NLS_LANG。

在使用本扩展之前，请确认已经为 Oracle 用户和 web daemon 用户正确设置了 Oracle 环境变量。这些变量应该在启动 web server 之前设定。下面列出了需要设置的环境变量：

• ORACLE_HOME

• ORACLE_SID

• LD_PRELOAD

• LD_LIBRARY_PATH

• NLS_LANG

在为 web 服务器用户设置环境变量之后，还需要将 web 服务器用户（nobody，www）加到 oracle 组中。

运行时配置

这些函数的行为受 php.ini 的影响。

以下是配置选项的简要解释。

预定义常量

以下常量由本扩展模块定义，因此只有在本扩展模块被编译到 PHP 中，或者在运行时被动态加载后才有效。

范例

例子 1. 基本查询 <?php $conn = oci_connect('hr', 'hr', 'orcl'); if (!$conn) {   $e = oci_error();   print htmlentities($e['message']);   exit; } $query = 'SELECT * FROM DEPARTMENTS'; $stid = oci_parse($conn, $query); if (!$stid) {   $e = oci_error($conn);   print htmlentities($e['message']);   exit; } $r = oci_execute($stid, OCI_DEFAULT); if(!$r) {   $e = oci_error($stid);   echo htmlentities($e['message']);   exit; } print '<table border="1">'; while($row = oci_fetch_array($stid, OCI_RETURN_NULLS)) {   print '<tr>';      foreach($row as $item) {        print '<td>'.($item?htmlentities($item):'&nbsp;').'</td>';      }      print '</tr>'; } print '</table>'; oci_close($conn); ?>

例子 2. 用绑定变量插入 <?php // Before running, create the table: //   CREATE TABLE MYTABLE (mid NUMBER, myd VARCHAR2(20)); $conn = oci_connect('scott', 'tiger', 'orcl'); $query = 'INSERT INTO MYTABLE VALUES(:myid, :mydata)'; $stid = oci_parse($conn, $query); $id = 60; $data = 'Some data'; oci_bind_by_name($stid, ':myid', $id); oci_bind_by_name($stid, ':mydata', $data); $r = oci_execute($stid); if($r)   print "One row inserted"; oci_close($conn); ?>

例子 3. 将数据插入到 CLOB 列中 <?php // Before running, create the table: //     CREATE TABLE MYTABLE (mykey NUMBER, myclob CLOB); $conn = oci_connect('scott', 'tiger', 'orcl'); $mykey = 12343;  // arbitrary key for this example; $sql = "INSERT INTO mytable (mykey, myclob)         VALUES (:mykey, EMPTY_CLOB())         RETURNING myclob INTO :myclob"; $stid = oci_parse($conn, $sql); $clob = oci_new_descriptor($conn, OCI_D_LOB); oci_bind_by_name($stid, ":mykey", $mykey, 5); oci_bind_by_name($stid, ":myclob", $clob, -1, OCI_B_CLOB); oci_execute($stid, OCI_DEFAULT); $clob->save("A very long string"); oci_commit($conn); // Fetching CLOB data $query = 'SELECT myclob FROM mytable WHERE mykey = :mykey'; $stid = oci_parse ($conn, $query); oci_bind_by_name($stid, ":mykey", $mykey, 5); oci_execute($stid, OCI_DEFAULT); print '<table border="1">'; while ($row = oci_fetch_array($stid, OCI_ASSOC)) {   $result = $row['MYCLOB']->load();   print '<tr><td>'.$result.'</td></tr>'; } print '</table>'; ?>

可以很容易地访问存储过程，就和从命令行访问一样。

例子 4. 使用存储过程 <?php // by webmaster at remoterealty dot com $sth = oci_parse($dbh, "begin sp_newaddress( :address_id, '$firstname', '$lastname', '$company', '$address1', '$address2', '$city', '$state', '$postalcode', '$country', :error_code );end;"); // This calls stored procedure sp_newaddress, with :address_id being an // in/out variable and :error_code being an out variable. // Then you do the binding:    oci_bind_by_name($sth, ":address_id", $addr_id, 10);    oci_bind_by_name($sth, ":error_code", $errorcode, 10);    oci_execute($sth); ?>

连接处理

OCI8 扩展提供了 3 个不同函数来连接 Oracle。取决于用户来使用对自己的应用程序最合适的函数。本节的信息有助于用户作出合适的选择。

连接到 Oracle 服务器从所需的时间上来讲是个相当花费的操作。oci_pconnect() 函数使用了一个连接的持久缓冲区，可以被不同的脚本请求重复使用。这意味着通常在每个 PHP 进程（或 Apache 子进程）中只需要连接一次。

如果应用程序连接 Oracle 时对每个 web 用户都使用了不同的认证信息，则由 oci_pconnect() 使用的持久缓冲区就用处不大了，因为随着并发用户的增加，到某个程度后会由于要保持太多的空闲连接而对 Oracle 服务器的整体性能起到逆反的影响。如果应用程序是这样的架构，建议要么用 oci8.max_persistent 和 oci8.persistent_timeout 配置选项（此二者可以使用户控制持久连接缓冲区的大小和生命周期）来协调应用程序，要么用 oci_connect() 来连接。

oci_connect() 和 oci_pconnect() 都使用了一个连接缓冲区。如果在某个脚本中用同样的参数多次调用 oci_connect()，则第二个和之后的调用会返回已有的连接句柄。oci_connect() 使用的连接缓冲区会在脚本执行完毕后或者明确地关闭了连接句柄时被清空。oci_pconnect() 有相似的行为，不过其缓冲区独立地维持着并在不同请求之间都存活着。

要记住此缓冲特性，因为它使两个句柄没有在事务级隔离开来（事实上是同一个连接句柄，因此没有任何方式的隔离）。如果应用程序需要两个独立的，事务级隔离的连接，应该使用 oci_new_connect()。

oci_new_connect() 总是创建一个到 Oracle 服务器的新连接，不管其它连接是否已经存在。高流量的 web 应用应该避免使用 oci_new_connect()，尤其是在程序最忙的部分。

驱动程序支持的数据类型