(作者:星空浪子 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 指令字串。