| 由于本函数库都是调用 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);
ocibindbyname($stmt, ":ename", &$ename, 32);
ocibindbyname($stmt, ":rid", &$rowid, -1, oci_b_rowid);
$update = ociparse($conn, "update emp set sal = :sal where rowid = :rid");
ocibindbyname($update, ":rid", &$rowid, -1, oci_b_rowid);
ocibindbyname($update, ":sal", &$sal, 32);
$sal = 10000;
while (list($empno, $ename) = each($data)) {
ociexecute($stmt);
ociexecute($update);
}
$rowid->free();
ocifreestatement($update);
ocifreestatement($stmt);
$stmt = ociparse($conn, "select * from emp where empno in (1111,2222,3333)");
ociexecute($stmt);
while (ocifetchinto($stmt, &$arr, oci_assoc)) {
var_dump($arr);
}
ocifreestatement($stmt);
/* 删除刚加在 emp 资料表中的三笔资料 */
$stmt = ociparse($conn, "delete from emp where empno in (1111,2222,3333)");
ociexecute($stmt);
ocifreestatement($stmt);
ocilogoff($conn);
?>
ocilogon
打开与 oracle 的链接。
语法: int ocilogon(string username, string password, string [ocacle_sid]);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数使 php 与 oracle 建立链接。参数 username 与 password 分别为连接的帐号及密码。参数 ocacle_sid 为数据库名称，可省略。返回值为连接的代码。
ocilogoff
关闭与 oracle 的链接。
语法: boolean ocilogoff(int connection);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数使 php 与 oracle 的链接结束。参数 connection 为连上 oracle 的连接代码。返回值 true 表示成功，false 表示发生错误。
ociexecute
执行 oracle 的指令部分。
语法: boolean ociexecute(int statement, int [mode]);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数用来执行指定的 oracle 指令部分，执行前必须先由 ociparse() 解析过该部分的 sql 语法。参数 statement 为解析过的代码。参数 mode 可省略，其默认值为 oci_commit_on_success。返回值 true 表示成功，false 表示发生错误。
ocicommit
将 oracle 的交易处理付诸实行。
语法: boolean ocicommit(int connection);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数会将最近一次 commit/rollback 后的交易 (transaction) 做永久性的修改。参数 connection 为连上 oracle 的连接代码。返回值 true 表示成功，false 表示发生错误。
ocirollback
撤消当前交易。
语法: boolean ocirollback(int connection);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数取消 oracle 交易处理 (transaction) 对数据库所做的修改。参数 connection 为连上 oracle 的连接代码。若成功则返回 true，反之返回 false。
ocinumrows
取得受影响字段的数目。
语法: int ocinumrows(int statement);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数返回受 update 等指令影响的字段 (column) 数目，若使用 select 等 sql 指令则不会有影响。参数 statement 为解析过的代码。
ociresult
从目前列 (row) 的资料取得一栏 (column)。
语法: string ociresult(int statement, mixed column);
返回值: 字符串
函数种类: 数据库功能
内容说明: 本函数返回返回一栏资料。参数 statement 为解析过的代码。参数 column 为字段名。若使用新的资料类型 (rowids、lobs 与 files) 返回亦均为字符串。
ocifetch
取得返回资料的一列 (row)。
语法: int ocifetch(int statement);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数用来取得一列非空的资料。参数 statement 为解析过的代码。返回值 true 表示成功取回一列，false 表示本列是空的或发生其它错误。
ocifetchinto
取回 oracle 资料放入数组。
语法: int ocifetchinto(array &result, int [mode]);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数将对 oracle 取回的资料放入数组 result 中。返回每列的字段数目，若失败则返回 false。参数 mode 可省略，默认值为 oci_num，其它还有 oci_assoc、oci_return_nulls 及 oci_return_lobs 等。
ocicolumnisnull
测试返回行是否为空的。
语法: boolean ocicolumnisnull(int stmt, mixed column);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数用来测试返回的行 (column) 是否为空值 (null)。返回 true 表示为空值。
ocicolumnsize
取得字段类型的大小。
语法: int ocicolumnsize(int stmt, mixed column);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数可以取得字段 (column) 类型 (type) 的大小。
ocinewdescriptor
初始新的 lob/file 描述。
语法: string ocinewdescriptor(int connection , int [type]);
返回值: 字符串
函数种类: 数据库功能
内容说明: 本函数用来初始化新的 lob/file 描述值。
ociparse
分析 sql 语法。
语法: int ociparse(int connection, string query);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数可用来分析 sql 语法或是 pl/sql 部分是否有错误。参数 connection 为连接代码。参数 query 为 sql 指令字符串
