本文旨在解决使用PHP TCPDF库时，如何根据数组中的数据动态生成多页PDF文档的问题。我们将展示如何利用循环结构和`AddPage()`方法，针对数组中的每个元素创建独立的PDF页面，从而灵活应对数据量不确定的场景，例如根据用户输入的宠物数量和信息生成独立的宠物推荐页面。
在使用PHP TCPDF库生成PDF文档时，有时需要根据数据动态地创建多个页面。例如，用户提交了一个包含多个宠物信息的表单，我们需要为每个宠物生成一个独立的页面。直接在TCPDF内部使用循环结构并不方便，但可以通过结合PHP的循环语句和TCPDF的AddPage()方法来实现。
核心思路：
利用PHP的循环结构（如foreach）遍历包含页面数据的数组，在每次循环中，将当前数据写入PDF文档，然后调用AddPage()方法创建一个新页面。
立即学习“PHP免费学习笔记（深入）”；
示例代码：
假设我们有一个名为 $pet_details 的数组，其中每个元素都包含一个宠物的信息，我们需要为每个宠物生成一个PDF页面。以下是示例代码：
<?php
require_once('tcpdf/tcpdf.php'); // 引入TCPDF库
// 创建TCPDF对象
$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
// 设置文档信息
$pdf->SetCreator(PDF_CREATOR);
$pdf->SetAuthor('Your Name');
$pdf->SetTitle('Pet Recommendations');
$pdf->SetSubject('Pet Recommendations');
$pdf->SetKeywords('TCPDF, PHP, PDF, Pets, Recommendations');
// 设置页眉和页脚信息 (可选)
$pdf->SetHeaderData(PDF_HEADER_LOGO, PDF_HEADER_LOGO_WIDTH, PDF_HEADER_TITLE, PDF_HEADER_STRING);
$pdf->setHeaderFont(Array(PDF_FONT_NAME_MAIN, '', PDF_FONT_SIZE_MAIN));
$pdf->setFooterFont(Array(PDF_FONT_NAME_DATA, '', PDF_FONT_SIZE_DATA));
// 设置默认等宽字体
$pdf->SetDefaultMonospacedFont(PDF_FONT_MONOSPACED);
// 设置页边距
$pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);
$pdf->SetHeaderMargin(PDF_MARGIN_HEADER);
$pdf->SetFooterMargin(PDF_MARGIN_FOOTER);
// 设置自动分页
$pdf->SetAutoPageBreak(TRUE, PDF_MARGIN_BOTTOM);
// 设置图片比例因子
$pdf->setImageScale(PDF_IMAGE_SCALE_RATIO);
// 设置字体
$pdf->setFont('stsongstdlight', '', 10); // 设置字体，根据需要选择合适的字体
// 循环遍历宠物信息数组
foreach ($pet_details as $pet_data) {
// 添加新页面
$pdf->AddPage();
// 构建HTML内容 (根据$pet_data的内容动态生成)
$html = '<h1>Recommendation for ' . $pet_data['name'] . '</h1>';
$html .= '<p>Breed: ' . $pet_data['breed'] . '</p>';
$html .= '<p>Age: ' . $pet_data['age'] . '</p>';
$html .= '<p>Recommendations: ' . $pet_data['recommendations'] . '</p>';
// 写入HTML内容
$pdf->writeHTML($html, true, false, true, false, '');
}
// 输出PDF文档
$pdf->Output('pet_recommendations.pdf', 'I'); // 'I'表示在浏览器中显示，'D'表示下载
?>代码解释：
- 引入TCPDF库： require_once('tcpdf/tcpdf.php'); 引入必要的TCPDF文件。确保TCPDF库已正确安装并路径正确。
- 创建TCPDF对象： $pdf = new TCPDF(...); 创建一个新的TCPDF对象，可以根据需要调整参数，如页面方向、单位、格式等。
- 设置文档信息： $pdf->SetCreator(...), $pdf->SetAuthor(...), $pdf->SetTitle(...) 设置PDF文档的元数据，如作者、标题等。
- 设置页眉和页脚 (可选): $pdf->SetHeaderData(...), $pdf->setHeaderFont(...), $pdf->setFooterFont(...) 设置页眉和页脚的内容和样式。
- 设置页边距： $pdf->SetMargins(...) 设置页面的左、上、右边距。
- 设置自动分页： $pdf->SetAutoPageBreak(...) 启用自动分页功能，当内容超出页面底部时自动创建新页面。
- 设置字体： $pdf->setFont(...) 设置文档的默认字体。确保选择的字体支持中文显示，例如使用stsongstdlight。
- 循环遍历数组： foreach ($pet_details as $pet_data) { ... } 遍历包含宠物信息的数组。
- 添加新页面： $pdf->AddPage(); 在每次循环开始时，调用AddPage()方法创建一个新的空白页面。
- 构建HTML内容： 根据 $pet_data 中的数据，动态构建HTML内容。这里使用字符串拼接，可以根据实际需求使用更复杂的模板引擎。
- 写入HTML内容： $pdf->writeHTML($html, true, false, true, false, ''); 将HTML内容写入当前页面。writeHTML()方法的参数可以控制HTML的解析和渲染方式。
- 输出PDF文档： $pdf->Output('pet_recommendations.pdf', 'I'); 将生成的PDF文档输出到浏览器或保存到文件中。'I' 表示在浏览器中显示，'D' 表示下载。
注意事项：
- 字体选择： 确保选择的字体支持中文显示。如果使用默认字体，可能会出现乱码。
- HTML内容： writeHTML()方法支持有限的HTML标签。复杂的布局可以使用CSS样式进行控制。
- 错误处理： 在实际应用中，应该添加错误处理机制，例如检查数组是否为空，以及TCPDF库是否加载成功。
- 内存占用： 如果需要生成大量页面，可能会导致内存占用过高。可以考虑分批生成PDF，或者使用TCPDF的流式输出功能。
- 路径问题： 确保require_once('tcpdf/tcpdf.php'); 中的路径是正确的，指向你安装的 TCPDF 库。
总结：
通过结合PHP的循环结构和TCPDF的AddPage()方法，我们可以灵活地根据数据动态生成多页PDF文档。这种方法适用于各种需要根据数据生成独立页面的场景，例如报告生成、发票打印等。关键在于合理构建HTML内容，并根据实际需求调整TCPDF的参数。
