PHP的FDF文档支持

作者:Uwe Steinmann  

来源:http://www.phpbuilder.com  

译者:znsoft webmaster@phpease.com http://www.phpease.com  



译注:(保留)  

作PHP已经有一年多了吧，从3.0到4.0，不能说有多高(我现在也只是大菜鸟,比起何、Hunte,差多了，当然还有别的高手),但也有些经验。从PHP的火热  到现在的平静， 一路看的多了，听的也多了，见过的"高手"(会写留言板，聊天室什么的)也多,静下来一想：PHP只是一种语言。它自有  它存在的必要。国内的web开发也只停留在低水平的层次，想当初国外在大力发展asp组件时我们却只会用asp,PHP也一样。不过要感谢  php,它让我得到了生平的第二份工作(第一份是asp的,当初狠学c/c++,怎么也没想到吧),当然也通过它认识了不少朋友,Hunte,陈老板，一蛇,  何志强(虽然至今没有联络，但他的文章让我受益非),sony,macro,cfr...　为了生计，为了将来的发展，小生将离开PHP界，虽然不愿，  但也无奈,将拖了很久的一篇文章译出来作为最后的礼物献给大家，献给所有使用PHP&mysql的朋友。如果有学习VC和驱动开发的朋友可以和  

我联络,让我们一起来探讨。  

---------------------------------------------------------------  





动机  



WWW上的交互意味着填表、点击submit按钮,然后得到一个确定的结果。Html和Http提供一个机制来通过表单很容易地执行这种操作。  PHP用一种非常便利的方法来支持这种机制,每个输入域(译注:表单的输入框)的值被存贮为一个与输入域同名的PHP变量。  



一个很相似的机制已经被adobe开发着,但是是为PDF文档。他们简单地叫它Acrobat 表单。 从用户的观点来看,Html表单和Acrobat表  单唯一的不同是它们的外观。前者使用HTML文档,后者使用PDF文档来呈现表单。  



要开发WEB界面,Acrobat表单也可以象HTML表单一样被处理,如果这个表单象HTML表单一样提供输入数据。然而,Adobe 已经为表单数  据提出一个新的格式叫FDF(表单数据格式)。PHP已经包含这种格式的支持。  



用数据生成一个PDF文档的可能性,如定制它,是Acrobat 表单的附加特性了.用PDF文档作为表单并且在PHP中用数据生成PDF文档将在 这篇文章中被描述。你会发现这两个例了是多么的容易。  



在你开始试这篇文章中的在线例子之前你要安装Acrobat阅读器插件或使用Acrobat 4.如果你想在自己的web服务器上测试php脚本你也要安装PDF工具包并使PHP中的FDF支持生效。  



最后,如果你开发你自己的PDF表单你需要Acrobat Exchange 3.x或Acrobat 4。  



在过去的几年中,Adobe已经开发出可便携文档格式(PDF)并且扩展了它。一种扩展是允许用户输入数据并送到服务器中处理的Acrobat  表单,就象HTML表单。  

这样的PDF文档与静态的PDF文档很相似,但当你用Acrobat阅读器看它时,你会发现可编辑的区域。  就象HTML中一样有很多输入域有效,例如 提交和重置按钮,文本输入域,检查框等等.. 创建这样一个PDF表单需要Acrobat Exchange 3.x或新的Acrobat 4软件,不幸的是它们只能在windows和MacOS中运行。

两者都提供一个方式来放置不同的输入域到一个已存在的PDF文档中。  

提交按钮传送在它被按下时调用的URL属性。这非常象HTML,但不同的是在数据被传送到服务器时的格式。  

在按下Submit按钮时，数据是用一个在URL中可以被观察的确定格式从HTML表单传输。Acrobat表单支持这种格式，还有FDF(表单数据格式)  FDP是一种新格式，需要FDF工具包(当前版本4.0)解释。如果PHP在编译时加了FDF支持，它就能解析FDF数据并且用名字存取任何输入域。  FDF数据一般被存在PHP的HTTP_RAW_POST_DATA变量中(就象HTML数据存储在HTTP_POAT_DATA中一样)  

数据的实际赋值是在PHP脚本中完成的，相反的是HTML提交数据是在PHP引擎中被赋值的。  



要想得到一个FDF数据看起来的样子,这儿是一个例子：(译注:从网上拷下的原始文件如此，我也看不清乱码是什么,不过如果放在英文系统中能看清吧)  



%FDF-1.2 %忏嫌 1 0 obj << /FDF << /Fields [ << /V (This is just some text for testing)/T (comment)>> ....  



这个仅仅是一个完整记录的第一部分，但它能明显地表示出输入域的注解(译注:可能是标题吧)和它的值。这儿是测试文本。  



这了让它更清楚,提供一个简单的例子。首先,假设我们有一个包含数量,出版者,准备者,日期，注解发行者，发行准备者等域的PDF表单。  前五个域是文本域,最后两个域是检查框(check box)。我们的PHP脚本总会显示数量、日期、注解域的值，当相应的检查框选中时才显示出版者、准备者域的值。  

如果这个框(check box)被选中，它们的值是"On"这是在表单被创建时设置的。当然这个表单也有提交按钮，在我们的这个例子中它甚至有reset按钮。  

点击提交按钮运行下面的脚本。这个脚本象上面所述的来赋域数据的值。  






$fdffp = fopen("test.fdf", "w");  

fwrite($fdffp, $HTTP_RAW_POST_DATA, strlen($HTTP_RAW_POST_DATA));  

fclose($fdffp);  



$fdf = fdf_open("test.fdf");  

$volume = fdf_get_value($fdf, "volume");  

echo "The volume field has the value '$volume'
";  



$date = fdf_get_value($fdf, "date");  

echo "The date field has the value '$date'
";  



$comment = fdf_get_value($fdf, "comment");  

echo "The comment field has the value '$comment'
";  



if(fdf_get_value($fdf, "show_publisher") == "On") {  

$publisher = fdf_get_value($fdf, "publisher");  

echo "The publisher field has the value '$publisher'
";  

} else  

echo "Publisher shall not be shown.
";  



if(fdf_get_value($fdf, "show_preparer") == "On") {  

$preparer = fdf_get_value($fdf, "preparer");  

echo "The preparer field has the value '$preparer'
";  

} else  

echo "Preparer shall not be shown.
";  

fdf_close($fdf);  



?>  



你可以试试这个例子 http://gehtnix.fernuni-hagen.de:8000/testfdf/example1.pdf  







比较实际情况，PDF表单比HTML表单有更好的外观，这种技术好象没有确切的优势。然而，PDF有另一种用处。你可以回顾一下上面的  

过程，并用数据组成一个PDF文档。  

如果你需要定制PDF文档中仅需的几个确定部分,象地址，日期等等。它也可以用于创建完整的PDF文档,但要用PHP的pdf文档功能创建混合文档  

需要很多工作。  

例如在通常情况下，它也值得用于设计者创建准备文档(译注:可能是草稿吧)。用PHP中的PDF文档功能创建PDF表单(译注:不是fdf文档)几乎不可能的。  



在FDF中用数据组成一个PDF文档很简单。你用Acrobat 4的话将必须创建一个PDF文档并在其中加入输入域。放到你的web服务器上。  然后，你需要用PHP创建FDF文档,它包含每个域，它的值和数据将被插入的文档的参考。(这个PDF文档你刚才已经建好了)。这个会在php中被飞快地处理。文档的参考是一个指向PDF文档的URL。  



以第一个例子为基础,下面的php脚本非常容易。脚本的第二部分已经加入了。  






$fdffp = fopen("test.fdf", "w");  

fwrite($fdffp, $HTTP_RAW_POST_DATA, strlen($HTTP_RAW_POST_DATA));  

fclose($fdffp);  



$fdf = fdf_open("test.fdf");  

$volume = fdf_get_value($fdf, "volume");  

$date = fdf_get_value($fdf, "date");  

$comment = fdf_get_value($fdf, "comment");  



if(fdf_get_value($fdf, "show_publisher") == "On") {  

$publisher = fdf_get_value($fdf, "publisher");  

} else  

$publisher = "";  



if(fdf_get_value($fdf, "show_preparer") == "On") {  

$preparer = fdf_get_value($fdf, "preparer");  

} else  

$preparer = "";  



fdf_close($fdf);  



$outfdf = fdf_create();  

fdf_set_value($outfdf, "f_volume", $volume, 0);  

fdf_set_value($outfdf, "b_volume", $volume, 0);  



fdf_set_value($outfdf, "f_comment", $comment, 0);  

fdf_set_value($outfdf, "b_comment", $comment, 0);  



fdf_set_value($outfdf, "f_date", $date, 0);  

fdf_set_value($outfdf, "b_date", $date, 0);  



fdf_set_value($outfdf, "f_preparer", $preparer, 0);  

fdf_set_value($outfdf, "b_preparer", $preparer, 0);  



fdf_set_value($outfdf, "f_publisher", $publisher, 0);  

fdf_set_value($outfdf, "b_publisher", $publisher, 0);  



fdf_set_file($outfdf, "http:/testfdf/resultlabel.pdf");  

fdf_save($outfdf, "outtest.fdf");  

fdf_close($outfdf);  

Header("Content-type: application/vnd.fdf");  

$fp = fopen("outtest.fdf", "r");  

fpassthru($fp);  

unlink("outtest.fdf");  



?>  



你也可以试试这个例子 http://gehtnix.fernuni-hagen.de:8000/testfdf/example2.pdf  



In this example several steps are performed:  

在这个例中几个步骤已经完成:  



用户已经埴完了PDF 表单 example2.pdf  

点击提交按钮后,提交按钮关联的URL已经被调用。在这个例子中,已经执行这个PHP脚本。PHP脚本检索FDF数据流中的数据并创建新的FDF文档  

它包含作为结果的PDF文档的数据。  



FDF文档用application/vnd.fdf类型送回。  



Acrobat插件读取数据并显示这个参考PDF文档。在此例中为 resultlabel.pdf。  



这仍不是FDF做的每件事,在这个教程中还有很多遗留的东西需要讨论。  

你可以在adobe的web网站检验这篇文档。