BS结构中使用PHP访问ORACLE LOB_PHP
ORACLE LOB数据模型
在B/S(Browser/Server,浏览器/服务器)应用系统中,需要存储的已不仅仅是简单的文字信息,同时还包括一些图片和音像资料或者是超长的文本。比如开发一套公文系统,公文中的图表、附件等二进制文件或超长文本将无法使用普通的字符或其他类型的数据描述,这就要求后台数据库要有存储这些数据的能力。运用Oracle LOB对象可实现该功能。
Oracle LOB是用来存储大量的二进制和文本数据的一种数据类型(一个LOB字段可存储可多达4GB的数据)。目前,它又分为两种类型:内部LOB和外部LOB。内部LOB将数据以字节流的形式存储在数据库的内部。因而,内部LOB的许多操作都可以参与事务,也可以像处理普通数据一样对其进行备份和恢复操作。Oracle8i支持三种类型的内部LOB:BLOB(二进制数据)、CLOB(单字节字符数据)、NCLOB(多字节国家字符数据)。其中CLOB和NCLOB类型适用于存储超长的文本数据,BLOB字段适用于存储大量的二进制数据,如图像、视频、音频等。目前,Oracle8i只支持一种外部LOB类型,即BFILE类型。在数据库内,该类型仅存储数据在操作系统中的位置信息,而数据的实体以外部文件的形式存在于操作系统的文件系统中。因而,该类型所表示的数据是只读的,不参与事务。该类型可帮助用户管理大量的由外部程序访问的文件。
PHP Oracle 8 函数分析
PHP中有两套ORACLE函数扩展库,其中的ORACLE8函数允许访问 Oracle8 和 Oracle7 数据库,这些函数使用了Oracle8 Call-Interface(OCI8),支持向 Oracle 位置标志符绑定局部和全局 PHP 变量,全面支持 LOB、FILE 和 ROWID,允许用户使用用户自定义的变量,即用户数据库的自定义对象类。
Oracle8函数库中函数OCIFetchInto用于取回一行数据记录放入数组中,该函数的语法描述如下:
int OCIFetchInto(array &result, int [mode])
其中,参数mode可省略,内定值为OCI_NUM。在访问Oracle LOB时,如果希望返回LOB对象,则mode应设为OCI_ASSOC OCI_RETURN_LOBS。
函数OCIBindByName用于将PHP变量与Oracle对象进行绑定,从而建立PHP与Oracle之间的数据通讯,该函数语法描述为:
boolean OCIBindByName(int stmt, string ph_name, mixed &variable, int length, int [type])
其中:参数stmt是经过Oracle解析函数OCIParse解析后的字串指标。参数ph_name即需绑定的ORACLE返回变量名称;参数variable前面一定要加&符号,表PHP变量地址。参数length为变量的长度,若设为-1则使用指定的variable变量的最大值;参数type可省略,其值有OCI_B_FILE(二进制文件)、OCI_B_CFILE(文本文件)、OCI_B_CLOB(文字LOB)、OCI_B_BLOB(位元LOB)及OCI_B_ROWID(ROWID)等数种。值得注意的是,如使用Oracle8中特有的新数据类型LOB/ROWID/BFILE时,需要先执行 OCINewDescriptor()函数,同时必须要将length参数设成 -1。
函数OCINewDescriptor用于初始化新的LOB/FILE描述。该函数语法描述为:
string OCINewDescriptor(int connection , int [type])
其中的type同OCIBindByName函数中的type定义。
必须的环境配置
使用PHP的ORACLE8函数库需要Oracle8客户端库。在使用这个扩展之前,请确认你已经为Oracle 用户和WEB daemon 用户正确设置了 Oracle 环境变量。下面列出了需要设置的环境变量:
ORACLE_HOME #ORACLE安装路径
ORACLE_SID # ORACLE数据库ID
LD_LIBRARY_PATH #LD联接库路径
NLS_LANG #ORALCE地区(语言)设置
ORA_NLS33 # ORA_NLS33路径
为Linux环境下验证以上变量是否正确,最佳的办法就是分别在oracle用户与nobody下执行:
# env
根据输出的结果,判断上述环境变量是否一致。
在为WEB 服务器用户设置环境变量之后,你还需要将WEB 服务器用户(nobody、 www)加到oracle组中。
有关ORACLE8客户端和PHP安装设置的详细说明,请参考相关的技术手册。
应用范例
在PHP中上载并将文件存储在ORACLE LOB字段中的应用范例如下:
//LOB对象初始化,获取PHP变量指针
$lob = OCINewDescriptor($conn, OCI_D_LOB);
//向有关的文件记录表添加纪录,ORACLE SQL语法解释
$stmt = OCIParse($conn,"update T_FILE set FILENAME='".$_FILES['FJ1']['name'].
"',FILETYPE='".$_FILES['F1']['type']."',FILES=EMPTY_BLOB() where FILEID=".$newid." returning FILES into :lob");
//绑定LOB变量
OCIBindByName($stmt, ':lob', &$lob, -1, OCI_B_BLOB);
OCIExecute($stmt, OCI_DEFAULT);//执行语句
if($lob->savefile($F1)){//将表单提交的文件通过lob指针存入ORACLE数据库
OCICommit($conn);
//成功上传
}else{
//未能成功上传
}
OCIFreeDesc($lob);
OCIFreeStatement($stmt);
//结束
在PHP中将文件从数据库中提取并下载的应用范例如下:
$stmt = OCIParse($conn,"SELECT * FROM T_ FILE WHERE FILEID =$ID");
OCIExecute($stmt);
if(OCIFetchInto($stmt,$result,OCI_ASSOC OCI_RETURN_LOBS)){
//输出文件类型信息供浏览器判断
header("Content-type: ".$result[FILETYPE]);
//输出文件名,浏览器可提示是否打开或下载该文件
header("Content-Disposition: attachment; filename=".$result[FILENAME]);
//以上关于header函数的使用可参考PHP manual,HTML的文件头信息请参考Internet RFC 2616。
//输出文件流,在此,浏览器获取文件内容,出现正在下载或直接打开文件的提示
echo $result[FILES];
}
OCIFreeStatement($stmt);
//结束
以上范例仅是应用的关键语句,并在Linux PHP Apache Oracle8i平台上通过了验证,读者可根据自身需要进行完善和补充。
结束语
本文探讨PHP对ORACLE LOB访问的实现,仅是PHP在B/S结构系统中基本运用技术所涉及的一个方面。笔者曾对比了JDBC与PHP-OCI两者的执行效率,以JDBC为访问引擎的OAS HTTP Server(HTTP Server为apache2.0)的响应速度要逊于建立在Linux Aache PHP-OCI平台之上的WEB Server,这其中当然有Linux的出色表现,但不可否认的是,PHP与OCI的组合是非常优秀的。
由于缺乏ORACLE LOB与PHP ORACLE8函数库相结合运用的尝试,在开发信息管理系统中,为实现对大型数据文件的管理,PHP在此方面的功能并未得到有效的利用,希望本文对从事PHP数据库技术却遇到此方面难题的程序员会有所帮助。