Oracle 8 数据库函数库的列举与具体介绍

　　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 描

查看本文来源