PHP3中使用ORACLE函数的使用说明

oracle|函数

(作者:星空浪子 zhongcfido@126.com)
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 值。

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 值。

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 指令字串。