登录
首页 >  文章 >  php教程

PHP生成PDF入门教程详解

时间：2025-08-03 17:36:50 301浏览 收藏

本文是一份全面的PHP动态生成PDF基础教程指南，旨在帮助开发者掌握利用PHP高效生成定制化PDF文档的技术。文章以Dompdf库为例，详细讲解了如何快速上手，将HTML转换为PDF，并着重解决了中文乱码问题，强调了嵌入中文字体和配置Dompdf选项的重要性。同时，针对样式兼容性问题，建议开发者保持CSS简洁，避免使用高级CSS特性。此外，文章还深入探讨了优化PDF生成性能与内存占用的实用技巧，包括精简HTML结构、优化图片资源以及采用异步处理和缓存机制。最后，还介绍了PDF生成的高级功能，如页眉页脚、水印、密码保护、目录书签和表格自动分页等，为开发者提供了更广阔的PDF应用场景。通过本文，开发者可以系统地学习PHP动态生成PDF的核心技术，并能根据实际需求灵活运用。

要解决PHP动态生成PDF中的中文乱码和样式兼容性问题，1. 需嵌入中文字体并通过$options->set('defaultFont', 'SimHei')设置默认字体或在CSS中使用@font-face引入字体文件；2. 确保Dompdf的isHtml5ParserEnabled和isRemoteEnabled设为true以支持HTML5和远程资源加载；3. 保持CSS简洁，避免使用Flexbox、Grid等Dompdf不支持的高级CSS特性，优先使用表格和基础样式布局；4. 通过逐步调试HTML内容定位渲染问题。要优化性能与内存占用，1. 精简HTML结构，减少嵌套和冗余标签；2. 压缩图片并控制分辨率，避免加载过大或过多远程图片；3. 适当调高PHP的memory_limit，如ini_set('memory_limit', '256M')；4. 对耗时较长的生成任务采用异步处理，如使用消息队列；5. 对重复内容启用文件缓存，避免重复生成。除了基础内容，PDF还可实现高级功能，1. 通过CSS的position: fixed结合特殊类名实现页眉页脚及动态页码；2. 使用背景图或API添加水印；3. 利用TCPDF或FPDF设置密码保护和权限控制；4. 生成可点击目录和书签以提升长文档体验；5. 确保表格结构规范以支持跨页自动分页并重复表头。所有这些功能的实现依赖于对PDF库特性的深入掌握及合理的技术选型。

php语言怎样实现动态生成 PDF 文件 php语言 PDF 文件生成的基础教程指南

在PHP里动态生成PDF文件，核心就是借助成熟的第三方库。这不像前端直接渲染那么直观，它更像是在服务器端“画”一份文档出来。最常用的几把“刷子”，在我看来，无非就是Dompdf、TCPDF和FPDF这几个，它们各有侧重，但都能完成任务，让你能够根据程序逻辑动态输出个性化的PDF报告、发票或任何你想要的文件。

要说上手最快，尤其对那些习惯了HTML和CSS的开发者，Dompdf绝对是首选。它能把你的HTML直接转成PDF，这简直是福音。当然，它也不是万能的，有些CSS特性它可能就不支持，或者支持得不好，但大部分常见布局都够用了。

首先，你需要通过Composer安装Dompdf：

composer require dompdf/dompdf

接着，PHP代码可以这样写：

<?php
require_once 'vendor/autoload.php';

use Dompdf\Dompdf;
use Dompdf\Options;

// 实例化Dompdf，可以设置一些选项，比如字体、是否启用远程图片等
$options = new Options();
$options->set('defaultFont', 'SimHei'); // 设置默认字体，解决中文问题
$options->set('isHtml5ParserEnabled', true); // 启用HTML5解析器
$options->set('isRemoteEnabled', true); // 允许加载远程图片或样式表

$dompdf = new Dompdf($options);

// 准备你的HTML内容，这可以是动态生成的
$html = '
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>动态生成的PDF</title>
    <style>
        body { font-family: "SimHei", sans-serif; margin: 20px; }
        h1 { color: #333; }
        p { line-height: 1.6; }
        .highlight { color: #e74c3c; font-weight: bold; }
        table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
        th { background-color: #f2f2f2; }
    </style>
</head>
<body>
    <h1>你好，这是一份动态生成的PDF文档！</h1>
    <p>这份文档是在PHP运行时，根据你的<span class="highlight">特定数据和逻辑</span>实时生成的。</p>
    <p>你可以想象它是一张发票、一份报告，或者任何需要<span class="highlight">格式化输出</span>的内容。</p>
    <table>
        <thead>
            <tr>
                <th>项目</th>
                <th>描述</th>
                <th>数量</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>商品A</td>
                <td>高性能处理器</td>
                <td>1</td>
            </tr>
            <tr>
                <td>商品B</td>
                <td>超大容量内存</td>
                <td>2</td>
            </tr>
        </tbody>
    </table>
    <p>当前的生成时间是：' . date('Y-m-d H:i:s') . '</p>
</body>
</html>
';

$dompdf->loadHtml($html);

// 设置纸张大小和方向，例如A4横向 'landscape' 或纵向 'portrait'
$dompdf->setPaper('A4', 'portrait');

// 渲染HTML为PDF
$dompdf->render();

// 输出PDF到浏览器或保存到文件
// 直接输出到浏览器（让用户下载）
$dompdf->stream("我的动态文档.pdf", array("Attachment" => true));

// 或者保存到服务器文件
// file_put_contents("我的动态文档_".time().".pdf", $dompdf->output());

?>

如果你需要更底层、更精确的控制，比如在PDF画布上直接绘制图形、线条，或者不需要HTML到PDF的转换，那么FPDF或TCPDF会是更好的选择。它们更像是“白板作画”，所有元素都需要你用代码一点点定位和绘制，学习曲线会陡峭一些，但灵活性也更高。

PHP生成PDF时，如何处理中文乱码和样式兼容性问题？

中文乱码和样式兼容性，这简直是PHP生成PDF时的两大“拦路虎”。我记得有次为了一个报表，光是字体嵌入就折腾了好久。Dompdf这类库，默认情况下对中文字体的支持并不完美，因为它需要将字体文件嵌入到PDF中才能正确显示。

解决中文乱码的关键在于：

  1. 嵌入中文字体： 你需要将中文字体文件（如SimHei.ttf、SourceHanSansCN-Normal.ttf等）放到你的项目目录中，并告诉Dompdf去使用它们。最直接的方法是在CSS中指定font-family，并确保Dompdf能找到这个字体文件。
    • 首先，下载一个常用的中文字体文件（例如SimHei.ttf）。
    • 在Dompdf的配置中，通过$options->set('defaultFont', 'SimHei');设置默认字体，或者在CSS中用@font-face规则引入：
      @font-face {
    font-family: 'SimHei';
    src: url('../fonts/SimHei.ttf') format('truetype'); /* 确保路径正确 */
}
body { font-family: 'SimHei', sans-serif; }
    • 确保Dompdf的isHtml5ParserEnabled和isRemoteEnabled选项设置为true，这有助于更好地解析HTML和加载外部资源（包括字体）。

样式兼容性方面，Dompdf对CSS的支持并非100%完整，它更像是一个“子集”。一些高级的CSS3特性（比如Flexbox、Grid布局、复杂的阴影、动画等）可能不会被正确渲染。我的经验是：