要使用这个函数库，要在安装 PHP 及 Apache Server 之前先将 Oracle 数据库安装好，并确定 Oracle 能够顺利运作。之后在 PHP 配置 (configure) 时加入 --with-oracle=DIR 的选项，DIR 就是 $ORACLE_HOME 环境变量，例如：
./configure --with-oracle=/abc/def/oracle/product/7.0.3 --with-apache=…/apache_1.3.x --enable-track-vars
以下的范例是 [email protected] (22-Jan-1999) 所提供的。这个范例是返回 Oracle 中 sid1 数据库 (Database) 的 EMP 资料表 (Table) 所有资料。帐号是 SCOTT、密码为 TIGER。
<?php putenv("ORACLE_SID=sid1"); putenv("ORACLE_HOME=/u01/app/oracle/product/8.0.5"); $handle = ora_plogon("SCOTT@sid1", "TIGER") or die; $cursor = ora_open($handle); ora_commitoff($handle); $query = "SELECT * FROM EMP"; ora_parse($cursor, $query) or die; ora_exec($cursor); echo "\n";
echo "$query\n\n";
$numcols = 0;
while(ora_fetch($cursor)) {
$numcols = ora_numcols($cursor);
for ($column=0; $column < $numcols; $column++) {
$data = trim(ora_getcolumn($cursor, $column));
if($data == "") $data = "NULL";
echo "$data\t";
}
echo "\n";
}
$numrows = ora_numrows($cursor);
echo "\nROWS RETURNED: $numrows\n";
echo "\n";
ora_close($cursor);
?>
[email protected] (05-Aug-1998) 指出 ORACLE_HOME 为 Oracle 的安装路径，ORACLE_SID 为 Oracle 的数据库名称，若不知道这二个环境变量可以用 sqlplus 连上 Oracle 来查证。
Ora_Bind: 链接 PHP 变量到 Oracle 参数。
Ora_Close: 关闭一个 Oracle 的 cursor。
Ora_ColumnName: 得到 Oracle 返回列 (Column) 的名称。
Ora_ColumnType: 得到 Oracle 返回列 (Column) 的类型。
Ora_Commit: 将 Oracle 的交易处理付诸实行。
Ora_CommitOff: 关闭自动执行 Oracle 交易改动的功能。
Ora_CommitOn: 打开自动执行 Oracle 交易改动的功能。
Ora_Error: 获得 Oracle 错误信息。
Ora_ErrorCode: 获得 Oracle 错误代码。
Ora_Exec: 执行 Oracle 的指令部分。
Ora_Fetch: 取得返回资料的一列 (row)。
Ora_GetColumn: 从返回列 (row) 的资料取得一栏 (column)。
Ora_Logoff: 结束与 Oracle 的链接。
Ora_Logon: 打开与 Oracle 的链接。
Ora_Open: 打开 Oracle 的 cursor。
Ora_Parse: 分析 SQL 语法。
Ora_Rollback: 撤消当前交易。
Ora_Do: 快速的 SQL 查询。
Ora_FetchInto: 取回 Oracle 资料放入数组。
Ora_ColumnSize: 取得字段类型的大小。
Ora_Numcols: 取得字段的数目。
Ora_PLogon: 打开与 Oracle 的长期链接。