What is FPDF?
FPDF is a PHP class which allows to generate PDF files with pure PHP, that is to say without using the PDFlib library. The advantage is that PDFlib requires a fee for a commercial usage. F from FPDF stands for Free: you may use it for any kind of usage and modify it to suit your needs.
FPDF可以让我们创建pdf文件而不用去调用PDFlib
这里可以下到最新的windows下的版本:
http://www.fpdf.org/en/dl.php?v=152&f=zip
这里可以下到中文手册:
http://www.fpdf.org/en/dl.php?id=72
若要其他版本可以到这里下到:
http://www.fpdf.org/
这也是FPDF的官方网站,如果有问题可以去上面问,回复的挺快的,我上午问了1个问题他们下午就回了。不过那上面的时间都是美国时间。
下面是一个很简单的用FPDF创建一个pdf文件并添加一页的例子
<?
define('FPDF_FONTPATH','fpdf152/font/');
require('fpdf152/fpdf.php');
$pdf = new FPDF;
$pdf->AddPage();
$pdf->Output('a.pdf', 'D');
?>
当然也可以用$pdf->open();来新建一个pdf文件
但是在这里,Addpage()包含了open(),他同时完成了新建一个pdf文件和添加1页两个步骤
上面例子里的define('FPDF_FONTPATH','fpdf152/font/');定义了存放字体文件的目录
具体下载了压缩包后就看到那个font文件夹了,只要指向那个文件夹就行了
上面这段程序还不能显示任何东西
现在来加两句
<?
define('FPDF_FONTPATH','fpdf152/font/');
require('fpdf152/fpdf.php');
$pdf = new FPDF;
$pdf->AddPage();
$pdf->SetFont('arial');
$pdf->Text(5,20,'test pdf');
$pdf->Output('a.pdf', 'D');
?>
SetFont()设定字体,这步在第1次调用FPDF的时候一定要,否则pdf文件打开时将会提示“没有定义字型“而什么都不显示
这里最好定义比较常用的字体,并且中文不支持。
要支持中文或支持比较偏的字体要用到AddFont(),但是我测试暂时没通过,希望哪位通过的可以指点一下 ^^
Text()打印一个字符串,横坐标为5,纵坐标为20,字符串内容为“test pdf”
关于最后的Output()里的参数'D'可以参照手册里,写的很清楚了
这样导出的pdf文件就会显示'test pdf'了。
如果兴趣好,再加上张图片
<?
define('FPDF_FONTPATH','fpdf152/font/');
require('fpdf152/fpdf.php');
$pdf = new FPDF;
$pdf->AddPage();
$pdf->SetFont('arial');
$pdf->Text(5,20,'test pdf');
$pdf->Image('jianxin_mark.jpg', 5, 30, 60, 50);
$pdf->Output('a.pdf', 'D');
?>
Image()可以在pdf中插入图片,前面是文件名,要包括路径,5是横坐标,30是纵坐标,60是图片宽度,50是高度
ok,这样一个又有文字又有图片的pdf文件就建立了 ^^
其实还有很多功能,手册中都有写,但不是很详细,需要各位自己去研究发掘了 ^^
php: PHP Version 5.0.0b4
apache: Apache/2.0.49 (Win32)
1,做为cgi来运行
2,做为module来运行
1,做为apache2的cgi运行
ScriptAlias /php/ "c:/php/"
AddType application/x-httpd-php .php
Action application/x-httpd-php "/php/php-cgi.exe"
上面的代码添加到httpd.conf
2,做为apache的模块运行
LoadModule php5_module "c:/php/sapi/php5apache2.dll"
AddType application/x-httpd-php .php
上面的代码添加到httpd.conf
PHP,即“PHP: Hypertext Preprocessor”,是一种广泛用于 Open Source(开放源代码)并可以嵌入 HTML 的多用途脚本语言。它的语法接近 C、Java 和 Perl,易于学习。该语言的主要目标是让 Web 开发人员快速的书写动态生成的网页,然而,PHP 的功能并不局限于此。PHP普遍被认为可以更快和更有效地实现复杂的编程任务,而且正是因为它的更稳定以及占用更少资源的优点成为开发B/S结构系统的必备的WEB脚本设计语言,扮演着类似中间件的角色,即语法解析与执行。
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数据库技术却遇到此方面难题的程序员会有所帮助。