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 中特有的新资料类型 LOB/ROWID/BFILE 等时需要先执行 OCINewDescriptor() 函数执行本函数成功则返回 true 值
使用范例
这个范例是 thies@digicolde 所提出的
<?php
$conn = OCILogon(scotttiger);
$stmt = OCIParse($connselect empno ename from emp);
/* 使用 OCIDefineByName 要在执行 OCIExecute 前 */
OCIDefineByName($stmtEMPNO&$empno);
OCIDefineByName($stmtENAME&$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 为资料的长度若设为 则使用指定的 variable 资料最大值参数 type 可省略其值有 OCI_B_FILE (二进位文件)OCI_B_CFILE (文字文件)OCI_B_CLOB (文字 LOB)OCI_B_BLOB (位 LOB) 及 OCI_B_ROWID (ROWID) 等数种治募注意的是欲使用 Oracle 中特有的新资料类型 LOB/ROWID/BFILE 等时需要先执行 OCINewDescriptor() 函数同时必须要将 length 参数设成 执行本函数成功则返回 true 值
使用范例
这个范例是 thies@digicolde 所提出的它加入三笔资料到 emp 资料表中并使用 ROWID 来更新资料
<?php
$conn = OCILogon(scott tiger);
$stmt = OCIParse($conninsert into emp (empno ename) values (:empno:ename) returning ROWID into :rid);
$data = array( => Larry => Bill => Jim);
$rowid = OCINewDescriptor($conn OCI_D_ROWID);
OCIBindByName($stmt :empno &$empno );
OCIBindByName($stmt :ename &$ename );
OCIBindByName($stmt :rid &$rowid OCI_B_ROWID);
$update = OCIParse($conn update emp set sal = :sal where ROWID = :rid);
OCIBindByName($update :rid &$rowid OCI_B_ROWID);
OCIBindByName($update :sal &$sal );
$sal = ;
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 ());
OCIExecute($stmt);
while (OCIFetchInto($stmt &$arr OCI_ASSOC)) {
var_dump($arr);
}
OCIFreeStatement($stmt);
/* 删除刚加在 emp 资料表中的三笔资料 */
$stmt = OCIParse($conn delete from emp where empno in ());
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 为字段名若使用新的资料类型 (ROWIDsLOBs 与 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_ASSOCOCI_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 描