PHP生成PDF文件：基于TCPDF的HTML表格精准导出实战指南-php教程-PHP中文网

PHP生成PDF文件：基于TCPDF的HTML表格精准导出实战指南

本文详解如何使用tcpdf将动态生成的html表格（含json数据渲染）可靠导出为pdf，重点解决“页面混杂输出”“中文乱码”“表格样式失效”等新手高频问题，并提供可直接运行的健壮代码结构。

本文详解如何使用tcpdf将动态生成的html表格（含json数据渲染）可靠导出为pdf，重点解决“页面混杂输出”“中文乱码”“表格样式失效”等新手高频问题，并提供可直接运行的健壮代码结构。

在PHP中将HTML表格导出为PDF，看似只需调用writeHTML()即可，但实践中常因执行流程错位、输出缓冲干扰、HTML结构不兼容导致PDF无法生成、内容空白或报错“Headers already sent”。你提供的代码正是典型场景：前端HTML页面与后端PDF生成逻辑混写于同一PHP文件，且未做输出隔离——当浏览器首次加载页面时，HTML已向客户端发送了HTTP响应头和主体内容；随后点击“Generate PDF”触发$_POST提交，PHP再次尝试用$tcpdf->Output()发送PDF二进制流，但此时HTTP头早已发出，导致TCPDF抛出致命错误（如Cannot modify header information），PDF根本无法下载。

✅ 正确做法是严格分离「展示页」与「生成页」逻辑。推荐采用单文件双模式结构（即同一PHP文件根据请求类型切换行为），并确保PDF生成路径绝不提前输出任何HTML、空格或BOM字符：

<?php // 1. 设置UTF-8编码，防止中文乱码基础问题
header('Content-Type: text/html; charset=utf-8');
mb_internal_encoding('UTF-8');

// 2. 判断是否提交PDF生成请求
if (!isset($_POST['generate_pdf'])) {
    // ▶ 展示模式：仅输出HTML表单与表格预览
    $askPriceBeds = '{"status":"success","postcode":"W14 9JH", ... }'; // 你的完整JSON
    $data = json_decode($askPriceBeds, true);
    $raw_data = $data['data']['raw_data'];
    ?><title>房价数据报表</title><h2>房价数据（JSON解析后）</h2>

Price	Lat	Lng	Bedrooms	Type	Distance
= htmlspecialchars($row['price']) ?>	= htmlspecialchars($row['lat']) ?>	= htmlspecialchars($row['lng']) ?>	= htmlspecialchars($row['bedrooms']) ?>	= htmlspecialchars($row['type']) ?>	= htmlspecialchars($row['distance']) ?>

addTTFfont('fonts/NotoSansCJKsc-Regular.ttf', 'TrueTypeUnicode', '', 32); // $pdf->setFont('notosanscjksc', '', 10); $pdf->setPrintHeader(false); $pdf->setPrintFooter(false); $pdf->setMargins(10, 10, 10); $pdf->setAutoPageBreak(TRUE, 15); $pdf->AddPage(); // ✅ 构建纯净HTML（仅table，无html/body/head标签，避免TCPDF解析异常） // 使用内联style控制边框与间距（TCPDF不支持CSS外部文件及复杂属性） $html = '

房价数据PDF报表

'; foreach ($raw_data as $row) { $html .= ''; } $html .= '

Price	Lat	Lng	Bedrooms	Type	Distance
' . htmlspecialchars($row['price']) . '	' . htmlspecialchars($row['lat']) . '	' . htmlspecialchars($row['lng']) . '	' . htmlspecialchars($row['bedrooms']) . '	' . htmlspecialchars($row['type']) . '	' . htmlspecialchars($row['distance']) . '

'; // ✅ writeHTML()第二个参数设为true，启用HTML解析（必须！） $pdf->writeHTML($html, true, false, true, false, ''); // ✅ 输出：'I'=浏览器内嵌打开，'D'=强制下载，'F'=保存服务器 $pdf->Output('house-price-report.pdf', 'D'); }

? 关键注意事项总结：

Article To Html

文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。

下载

严禁混合输出：生成PDF时，PHP脚本中不能有任何echo、print、HTML标签或空白符（包括文件末尾换行），否则破坏PDF二进制结构；
表格必须带border="1"：TCPDF忽略CSS border，仅识别HTML border属性；
避免<div>包裹表格：TCPDF对<code><div>嵌套支持极弱，直接将<code><table>作为顶层元素最稳定； <li> <strong>数据安全处理</strong>：务必用<code>htmlspecialchars()转义动态内容，防止XSS及HTML解析崩溃；

性能优化：若数据超200行，建议启用分页控制（$pdf->setAutoPageBreak(TRUE, 15)）并压缩图片（如需插入Logo）；

替代方案提示：如需完美还原CSS Flex/Grid或Web字体，建议升级至laravel-snappy（wkhtmltopdf）或playwright-php，但需额外部署浏览器环境。

遵循以上结构与规范，你即可稳定、高效地将任意JSON驱动的HTML表格一键生成专业PDF文档。