PHP在网页中动态生成PDF文件详细教程

本文详细介绍使用 php 动态构建 pdf 文件的整个过程。使用免费 pdf 库 (fpdf) 或 pdflib-lite 等开源工具进行实验，并使用 php 代码控制 pdf 内容格式。

有时您需要准确控制要打印的页面的呈现方式。在这种情况下，html 就不再是最佳选择了。pdf 文件使您能够完全控制页面的呈现方式，以及文本、图形和图像在页面上的呈现方式。遗憾的是，用来构建 pdf 文件的 api 不属于 php 工具包的标准部件。现在您需要提供一点帮助。

当您在网络上搜索，寻找对 php 的 pdf 支持时，您首先发现的可能是商业 pdflib 库及其开源版本 pdflib-lite。 这些都是很好的库，但是商业版本相当昂贵。pdflib 库的精简版本库仅作为原始版本分发，当您尝试在托管环境下安装精简版本时，就会出现这个限制问题。

另一种选择是免费 pdf 库 (fpdf)，它是本机 php，无需要进行任何编译，是完全免费的，因此，您不会像在未许可版本的 pdflib 中那样看到水印。这个免费的 pdf 库正是我在本文中会用到的库。

我们将使用女子旱滑比赛的得分来演示动态构建 pdf 文件的过程。这些得分是从 web 中获得并被转换成 xml。清单 1 显示了一个示例 xml 数据文件。

清单 1. xml 数据

<events> 
 <event name="beast of the east 2011">
  <game score1="88" team1="toronto gore-gore rollergirls" team2="montreal la racaille" score2="11">
  <game score1="58" team1="toronto death track dolls" team2="montreal les contrabanditas" score2="49">
   ...
 </game></game></event>
 <event name="dustbowl invitational 2011">
   ...
 </event>
 <event name="the great yorkshire showdown 2011">
   ...
 </event>
</events>

xml 的根元素是一个 events 标记。按事件对数据进行分组，每个事件都包含多个比赛。在 events 标记内，是一系列的 event 标记，在这些标记中有多个 game 标记。 这些 game 标记中包含参加比赛的两个队的名称以及他们在比赛中的得分。

清单 2 展示了用来读取 xml 的 php 代码。

<?php
function getresults() {
 $xml = new domdocument(); 
 $xml->load('events.xml'); 
 $events = array();
 foreach($xml->getelementsbytagname('event') as $event) { 
  $games = array();
  foreach($event->getelementsbytagname('game') as $game) {
   $games []= array( 'team1' => $game->getattribute('team1'),
    'score1' => $game->getattribute('score1'),
    'team2' => $game->getattribute('team2'),
    'score2' => $game->getattribute('score2') );
  }
  $events []= array( 'name' => $event->getattribute('name'),
   'games' => $games );
 }
 return $events;
}
?>

这段脚本实现了一个 getresults 函数，以便将 xml 文件读入 dom 文档。然后使用 dom 调用遍历所有 event 和 game 标记，以构建一个事件阵列。该数列内的每个元素都是一个散列表，包含事件名称和比赛项目的阵列。结构基本上是 xml 结构的内存版。

为了测试这个脚本的作用，将构建一个 html 导出页面，使用 getresults 函数读取文件，然后以一系列 html 表的形式输出数据。清单 3 显示了该测试所用的 php 代码。

清单 3. 结果 html 页面

<?php
include_once('getresults.php');
$results = getresults();
foreach( $results as $event ) {
?>
<h1><?php echo( $event['name'] ) ?></h1>

<?php
foreach( $event['games'] as $game ) {
 $s1 = (int)$game['score1'];
 $s2 = (int)$game['score2'];
?>

<?php
}
?>
<table><tbody><tr>
 <td style="font-weight:<?php echo( ( $s1 > $s2 ) ? 'bold' : 'normal') ?>">
  <?php echo( $game['team1'] ) ?></td>
 <td><?php echo( $s1 ) ?></td>
 <td style="font-weight:<?php echo( ( $s2 > $s1 ) ? 'bold' : 'normal') ?>">
  <?php echo( $game['team2'] ) ?></td>
 <td><?php echo( $s2 ) ?></td>
</tr></tbody></table>
<?php
}
?>

通过代码 getresults.php，xml 数据文件被上传到 web 服务器，您可以查看 html 结果，这与 图 1 类似。
图 1. html 格式的竞赛结果

在该结果中，对获胜队使用了粗体，以便查看哪支队赢得了哪场比赛。

构建 pdf

获得数据之后，应将重点放在构建 pdf 文件上。第一步是下载 fpdf 库，然后将其安装在与现有应用文件集相同的目录中。实际上，只要是在 php 库路径中，您可以将它安装在任何您喜欢的地方。追踪您放置字体目录的地方，因为您需要设置 ‘fpdf_fontpath'，如 清单 4 所示。

清单 4. pdf hello world

<?php
define('fpdf_fontpath','/library/webserver/documents/derby/font/');

require( 'fpdf.php' );

$pdf = new fpdf();
$pdf->setfont('arial','',72);
$pdf->addpage();
$pdf->cell(40,10,"hello world!",15);
$pdf->output();
?>

这段脚本实际上是一个 “hello world”，但采用的是 pdf 格式而不是 html。这段脚本执行的第一个操作是使用 define 语句设置 fpdf 字体目录的位置。然后使用 require 语句引入 fpdf 库。这段脚本从该库创建了一个 fpdf 对象，设置字体，添加一个页面，然后使用 cell 方法将一些文本放在该页面上，并输出 pdf。

图 2 展示了一切都正常情况下的结果。

图 2. pdf 格式的 hello world

如果没有看到 pdf，那么您可能想在命令行运行这段脚本，查看是否丢失了 fpdf.php 文件或者存在其他问题。

既然 pdf 呈现正常，那么现在应该将其与旱滑结果文件合并，并查看可以动态生成哪些内容。清单 5 展示了该合并操作的第一个版本。

清单 5. 显示结果的首版 pdf

<?php
define('fpdf_fontpath','/library/webserver/documents/derby/font/');

require( 'fpdf.php' );
require( 'getresults.php' );

class pdf extends fpdf
{
function eventtable($event)
{
  $this->cell(40,10,$event['name'],15);
  $this->ln();
}
}

$pdf = new pdf();
$pdf->setfont('arial','',48);
foreach( getresults() as $event ) {
 $pdf->addpage();
 $pdf->eventtable($event); 
}
$pdf->output();
?>

我们没有从外部扩展 fpdf 类别，而是使用我们自己的 pdf 子类来扩展 fpdf 类别。在这些子类内，我们创建了一个名为 eventtable 的新方法，为给定事件构建了一个结果表。在这种情况下，我们从小处着手，只输出了事件名称。该名称位于脚本底部，包装在 foreach 循环中，该脚本为每个事件添加一个页面，然后调用 eventtable 方法。

可在 图 3 中看到这段脚本的输出。

图 3. 动态 pdf 的第一个版本

向下滚动页面，以展示每个事件都在自己的页面上。此处的下一步操作是开始将结果添加到页面。

构建结果表

在构建 pdf 文件时，构建无表结构就像构建 html 一样简单。构建表的方法是构建许多宽度、字体、填充颜色、行颜色等各不相同的单元。

清单 6 展示了设置表的标题栏的添加代码。

清单 6. 添加结果表标题

<?php
define('fpdf_fontpath','/library/webserver/documents/derby/font/');

require( 'fpdf.php' );
require( 'getresults.php' );

class pdf extends fpdf
{
function eventtable($event)
{
  $this->setfont('','b','24');
  $this->cell(40,10,$event['name'],15);
  $this->ln();

  $this->setxy( 10, 45 );

  $this->setfont('','b','10');
  $this->setfillcolor(128,128,128);
  $this->settextcolor(255);
  $this->setdrawcolor(92,92,92);
  $this->setlinewidth(.3);

  $this->cell(70,7,"team 1",1,0,'c',true);
  $this->cell(20,7,"score 1",1,0,'c',true);
  $this->cell(70,7,"team 2",1,0,'c',true);
  $this->cell(20,7,"score 2",1,0,'c',true);
  $this->ln();
}
}

$pdf = new pdf();
$pdf->setfont('arial','',10);
foreach( getresults() as $event ) {
 $pdf->addpage();
 $pdf->eventtable($event); 
}
$pdf->output();
?>

此处的添加代码用于设置字体、颜色和行宽。然后它将呈现包含四个标题列的几个单元格。然后调用 ln 方法（该方法与回车键等效）启用一个新行。

在浏览器中查看这段脚本时，可以看到类似 图 4 的内容。

图 4. 包含表的标题行的页面

在 图 4 中，标题以白色文本呈现在灰色背景上。这种格式有助于将其与呈现在标题下面的数据进行区分。要呈现比赛结果，请在 清单 7 中添加以下代码。

清单 7. 添加完整的结果表

<?php
define('fpdf_fontpath','/library/webserver/documents/derby/font/');

require( 'fpdf.php' );
require( 'getresults.php' );

class pdf extends fpdf
{
function eventtable($event)
{
  $this->setfont('','b','24');
  $this->cell(40,10,$event['name'],15);
  $this->ln();

  $this->setfont('','b','10');
  $this->setfillcolor(128,128,128);
  $this->settextcolor(255);
  $this->setdrawcolor(92,92,92);
  $this->setlinewidth(.3);

  $this->cell(70,7,"team 1",1,0,'c',true);
  $this->cell(20,7,"score 1",1,0,'c',true);
  $this->cell(70,7,"team 2",1,0,'c',true);
  $this->cell(20,7,"score 2",1,0,'c',true);
  $this->ln();

  $this->setfillcolor(224,235,255);
  $this->settextcolor(0);
  $this->setfont('');

  $fill = false;

  foreach($event['games'] as $game)
  {
    $this->setfont('times',((int)$game['score1']>(int)$game['score2'])?'bi':'');
    $this->cell(70,6,$game['team1'],'lr',0,'l',$fill);
    $this->cell(20,6,$game['score1'],'lr',0,'r',$fill);
    $this->setfont('times',((int)$game['score1']<(int)$game['score2'])?'bi':'');
    $this->cell(70,6,$game['team2'],'lr',0,'l',$fill);
    $this->cell(20,6,$game['score2'],'lr',0,'r',$fill);
    $this->ln();
    $fill =! $fill;
  }
  $this->cell(180,0,'','t');
}
}

$pdf = new pdf();
$pdf->setfont('arial','',10);
foreach( getresults() as $event ) {
 $pdf->addpage();
 $pdf->eventtable($event); 
}
$pdf->output();
?>

除了标题行之外，在 eventtable 方法中还有一个 foreach 循环，它将在每个比赛上进行迭代。图 5 显示了用于此用途的代码。

图 5. 包含结果表的 pdf

$fill 变量可通过切换来改变表中每行的颜色。优胜队的名称和得分用加粗、斜体字体表示，这样可以清晰显示它们。还需注意的是，字体从标题的 arial 字体更改成了显示比赛内容所用的 times 字体。

要完成示例代码，则需要添加一些图形。

使用图形进行修饰

向 pdf 添加图像非常容易。首先需要从 web 抓取一个图像。我抓取了一个旱滑参赛队的徽标，并将其存储为 png 格式的图像。 此后，我一直使用 清单 8 中的新代码。

清单 8. 添加徽标图像

<?php
define('fpdf_fontpath','/library/webserver/documents/derby/font/');

require( 'fpdf.php' );
require( 'getresults.php' );

class pdf extends fpdf
{
function eventtable($event)
{
  $this->image('logo.png',5,5,33);

  $this->setxy( 40, 15 );

  $this->setfont('','b','24');
  $this->cell(40,10,$event['name'],15);
  $this->ln();

  $this->setxy( 10, 45 );

  $this->setfont('','b','10');
  $this->setfillcolor(128,128,128);
  $this->settextcolor(255);
  $this->setdrawcolor(92,92,92);
  $this->setlinewidth(.3);

  $this->cell(70,7,"team 1",1,0,'c',true);
  $this->cell(20,7,"score 1",1,0,'c',true);
  $this->cell(70,7,"team 2",1,0,'c',true);
  $this->cell(20,7,"score 2",1,0,'c',true);
  $this->ln();

  $this->setfillcolor(224,235,255);
  $this->settextcolor(0);
  $this->setfont('');

  $fill = false;

  foreach($event['games'] as $game)
  {
   $this->setfont('times',((int)$game['score1']>(int)$game['score2'])?'bi':'');
   $this->cell(70,6,$game['team1'],'lr',0,'l',$fill);
   $this->cell(20,6,$game['score1'],'lr',0,'r',$fill);
   $this->setfont('times',((int)$game['score1']<(int)$game['score2'])?'bi':'');
   $this->cell(70,6,$game['team2'],'lr',0,'l',$fill);
   $this->cell(20,6,$game['score2'],'lr',0,'r',$fill);
   $this->ln();
   $fill =! $fill;
  }
  $this->cell(180,0,'','t');
}
}

$pdf = new pdf();
$pdf->setfont('arial','',10);
foreach( getresults() as $event ) {
 $pdf->addpage();
 $pdf->eventtable($event); 
}
$pdf->output();
?>

清单 8中的关键方法是 image 方法，它为图像、位置和宽度选取一个文件名称。所有其它参数都是可选的，因此您只指定您想要的信息便可。

到 setxy 的一些新调用会将文本和表左右移动到适当的位置，防止其覆盖图像。

图 6 显示了这段脚本的输出结果。

图 6. 带有徽标图像的已完成的 pdf

该 pdf 库还提供了其他方法来呈现图形、添加流文本、添加超链接、管理页边距和方向等结构，您可以完全控制您的 pdf 文件。

结束语

使用合适的工具，通过 php 构建 pdf 文件是非常容易的。这种方法非常适用于打印发x票或票据，或填写表单，以及需要严格控制内容布局的任何项目。