日期:2010-10-08  浏览次数:20572 次


由于本函数库都是调用 Oracle8 Call-Interface (OCI8) 来存取 Oracle 数据库,因此在装设 Oracle 8 Client 的 Web 服务器上,可用本函数库存取 Oracle 7.x 或 8.x 二种版本的数据库服务器。


OCIDefineByName: 让 SELECT 指令可使用 PHP 变量。
OCIBindByName: 让动态 SQL 可使用 PHP 变量。
OCILogon: 打开与 Oracle 的链接。
OCILogOff: 关闭与 Oracle 的链接。
OCIExecute: 执行 Oracle 的指令部分。
OCICommit: 将 Oracle 的交易处理付诸实行。
OCIRollback: 撤消当前交易。
OCINumRows: 取得受影响字段的数目。
OCIResult: 从目前列 (row) 的资料取得一栏 (column)。
OCIFetch: 取得返回资料的一列 (row)。
OCIFetchInto: 取回 Oracle 资料放入数组。
OCIColumnIsNULL: 测试返回行是否为空的。
OCIColumnSize: 取得字段类型的大小。
OCINewDescriptor: 初始新的 LOB/FILE 描述。
OCIParse: 分析 SQL 语法。

OCIDefineByName
让 SELECT 指令可使用 PHP 变量。
语法: boolean OCIDefineByName(int stmt, string ColumnName, mixed &variable, int [type]);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数用来定义指定的 PHP 变量,使其能供 SQL 指令中的 SELECT 指令使用。在大小写的问题上要注意一下,因为 Oracle 数据库中的字段名称其实都是大写的名字。参数 stmt 是经过 Oracle 解析 (OCIParse) 后的字符串指针。参数 ColumnName 是 Oracle 资料表上的字段名称。参数 variable 前面一定要加 & 符号,表 PHP 变量位址。参数 type 通常省略。治募注意的是欲使用 Oracle 8 中特有的新资料类型 LOB/ROWID/BFILE 等时,需要先执行 OCINewDescriptor() 函数。执行本函数成功则返回 true 值。
使用范例
这个范例是 thies@digicol.de 所提出的
<?php
$conn = OCILogon("scott","tiger");
$stmt = OCIParse($conn,"select empno, ename from emp");
/* 使用 OCIDefineByName 要在执行 OCIExecute 前 */
OCIDefineByName($stmt,"EMPNO",&$empno);
OCIDefineByName($stmt,"ENAME",&$ename);
OCIExecute($stmt);
while (OCIFetch($stmt)) {
echo "empno:".$empno."\n";
echo "ename:".$ename."\n";
}
OCIFreeStatement($stmt);
OCILogoff($conn);
?>

OCIBindByName
让动态 SQL 可使用 PHP 变量。
语法: boolean OCIBindByName(int stmt, string ph_name, mixed &variable, int length, int [type]);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数用来定义指定的 PHP 变量,使其能供动态的 SQL 指令 (Oracle Placeholder) 使用。在大小写的问题上要注意一下,因为 Oracle 数据库中的字段名称其实都是大写的名字。参数 stmt 是经过 Oracle 解析 (OCIParse) 后的字符串指针。参数 ph_name 即为欲供动态 SQL 指令所使用的变量。参数 variable 前面一定要加 & 符号,表 PHP 变量位址。参数 length 为资料的长度,若设为 -1 则使用指定的 variable 资料最大值。参数 type 可省略,其值有 OCI_B_FILE (二进位文件)、OCI_B_CFILE (文字文件)、OCI_B_CLOB (文字 LOB)、OCI_B_BLOB (位 LOB) 及 OCI_B_ROWID (ROWID) 等数种。治募注意的是欲使用 Oracle 8 中特有的新资料类型 LOB/ROWID/BFILE 等时,需要先执行 OCINewDescriptor() 函数,同时必须要将 length 参数设成 -1。执行本函数成功则返回 true 值。
使用范例
这个范例是 thies@digicol.de 所提出的,它加入三笔资料到 emp 资料表中,并使用 ROWID 来更新资料。
<?php
$conn = OCILogon("scott", "tiger");
$stmt = OCIParse($conn,"insert into emp (empno, ename) "."values (:empno,:ename) "."returning ROWID into :rid");
$data = array(1111 => "Larry", 2222 => "Bill", 3333 => "Jim");
$rowid = OCINewDescriptor($conn, OCI_D_ROWID);
OCIBindByName($stmt, ":empno", &$empno, 32);