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字符：

Article To Html

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

下载

<?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'];
    ?>
    <!DOCTYPE html>
    <html>
    <head><title>房价数据报表</title></head>
    <body>
        <h2>房价数据（JSON解析后）</h2>
        <table border="1" style="border-collapse:collapse; width:100%;">
            <thead>
                <tr style="background:#f0f0f0;">
                    <th style="padding:6px;">Price</th>
                    <th style="padding:6px;">Lat</th>
                    <th style="padding:6px;">Lng</th>
                    <th style="padding:6px;">Bedrooms</th>
                    <th style="padding:6px;">Type</th>
                    <th style="padding:6px;">Distance</th>
                </tr>
            </thead>
            <tbody>
                <?php foreach ($raw_data as $row): ?>
                <tr>
                    <td style="padding:4px;"><?= htmlspecialchars($row['price']) ?></td>
                    <td style="padding:4px;"><?= htmlspecialchars($row['lat']) ?></td>
                    <td style="padding:4px;"><?= htmlspecialchars($row['lng']) ?></td>
                    <td style="padding:4px;"><?= htmlspecialchars($row['bedrooms']) ?></td>
                    <td style="padding:4px;"><?= htmlspecialchars($row['type']) ?></td>
                    <td style="padding:4px;"><?= htmlspecialchars($row['distance']) ?></td>
                </tr>
                <?php endforeach; ?>
            </tbody>
        </table>
        <form method="POST">
            <button type="submit" name="generate_pdf">? 生成PDF报表</button>
        </form>
    </body>
    </html>
    <?php
} else {
    // ▶ PDF生成模式：完全静默执行，不输出任何HTML
    require_once('tcpdf/tcpdf.php');

    // ✅ 关键：禁用所有可能的输出缓冲干扰
    if (ob_get_level()) ob_end_clean();

    // 创建TCPDF实例（注意：必须指定UTF-8编码）
    $pdf = new TCPDF('P', 'mm', 'A4', true, 'UTF-8', false);

    // ⚠️ 中文支持三步法（若需中文）：
    // ① 将NotoSansCJKsc-Regular.ttf放入tcpdf/fonts/目录
    // ② 运行转换命令：php tcpdf/fonts/utils/ttf2ufm.php -f -F NotoSansCJKsc-Regular.ttf
    // ③ 注册并设置字体（示例）：
    // $pdf->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 = '<h3 style="text-align:center;">房价数据PDF报表</h3>
    <table border="1" style="border-collapse:collapse; width:100%; font-size:9pt;">
        <thead>
            <tr style="background-color:#e0e0e0;">
                <th style="padding:5px; text-align:left;">Price</th>
                <th style="padding:5px; text-align:left;">Lat</th>
                <th style="padding:5px; text-align:left;">Lng</th>
                <th style="padding:5px; text-align:left;">Bedrooms</th>
                <th style="padding:5px; text-align:left;">Type</th>
                <th style="padding:5px; text-align:left;">Distance</th>
            </tr>
        </thead>
        <tbody>';

    foreach ($raw_data as $row) {
        $html .= '<tr>
            <td style="padding:4px;">' . htmlspecialchars($row['price']) . '</td>
            <td style="padding:4px;">' . htmlspecialchars($row['lat']) . '</td>
            <td style="padding:4px;">' . htmlspecialchars($row['lng']) . '</td>
            <td style="padding:4px;">' . htmlspecialchars($row['bedrooms']) . '</td>
            <td style="padding:4px;">' . htmlspecialchars($row['type']) . '</td>
            <td style="padding:4px;">' . htmlspecialchars($row['distance']) . '</td>
        </tr>';
    }

    $html .= '</tbody></table>';

    // ✅ writeHTML()第二个参数设为true，启用HTML解析（必须！）
    $pdf->writeHTML($html, true, false, true, false, '');

    // ✅ 输出：'I'=浏览器内嵌打开，'D'=强制下载，'F'=保存服务器
    $pdf->Output('house-price-report.pdf', 'D');
}

? 关键注意事项总结：

严禁混合输出：生成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文档。

立即学习“PHP免费学习笔记（深入）”；