PHP动态生成PDF并提供下载需借助第三方库:一、TCPDF支持中文与HTML渲染;二、Dompdf兼容HTML/CSS转换;三、MPDF适合复杂排版;四、原生php-pdf扩展性能高但开发复杂。

如果需要在PHP应用中动态生成PDF文件并提供下载功能,则通常需借助第三方库来完成PDF内容的渲染与输出。以下是实现该功能的具体步骤:
一、使用TCPDF库生成PDF
TCPDF是一个纯PHP编写的开源PDF生成库,支持中文(需配置字体)、HTML解析、页眉页脚、表格和图像嵌入等功能,适用于报表类PDF生成。
1、通过Composer安装TCPDF:运行命令 composer require tecnickcom/tcpdf。
2、在PHP文件中引入TCPDF类:使用 require_once 'vendor/autoload.php'; 加载自动加载器。
立即学习“PHP免费学习笔记(深入)”;
3、实例化TCPDF对象并设置文档属性:调用 new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false),并调用 setLanguageArray() 配置中文语言支持。
4、添加中文字体:将支持Unicode的TrueType字体(如simhei.ttf)放入fonts目录,并执行 $pdf->addTTFfont('fonts/simhei.ttf', 'TrueTypeUnicode', '', 32),再设置默认字体为该字体。
5、写入HTML内容:调用 $pdf->writeHTML($html_content, true, false, true, false, ''),其中$html_content为含中文的HTML字符串。
6、输出PDF:使用 $pdf->Output('report.pdf', 'D') 强制浏览器下载PDF文件。
二、使用Dompdf库生成PDF
Dompdf将HTML和CSS渲染为PDF,语法兼容性较好,适合从已有HTML报表页面直接转换,对响应式布局支持有限但足够满足常规打印需求。
1、通过Composer安装Dompdf:运行命令 composer require dompdf/dompdf。
2、引入Autoloader:使用 require_once 'vendor/autoload.php';。
3、创建Dompdf实例并配置选项:实例化时传入 new Dompdf(['enable_remote' => true]) 以允许加载远程图片资源。
4、加载HTML内容:调用 $dompdf->loadHtml($html, 'UTF-8'),确保HTML中包含meta charset声明。
5、设置纸张大小与方向:调用 $dompdf->setPaper('A4', 'portrait')。
6、渲染并输出:执行 $dompdf->render() 后,调用 $dompdf->stream('report.pdf') 触发下载。
三、使用MPDF库生成PDF
MPDF是高性能PDF生成器,对CSS支持更全面,尤其擅长处理复杂排版、多栏、页码、水印及中文直排等高级特性,适合生成正式业务报表。
1、通过Composer安装MPDF:运行命令 composer require mpdf/mpdf。
2、引入类文件:使用 require_once __DIR__ . '/vendor/autoload.php';。
3、初始化MPDF对象并指定中文字体:构造时传入 ['mode' => 'utf-8', 'format' => 'A4', 'default_font' => 'dejavusans'],该字体内置中文支持。
4、写入HTML内容:调用 $mpdf->WriteHTML($html),可多次调用以拼接内容。
5、添加页眉页脚:使用 $mpdf->SetHTMLHeader() 和 $mpdf->SetHTMLFooter() 注入HTML片段。
6、输出PDF:调用 $mpdf->Output('report.pdf', 'D') 实现强制下载。
四、原生PDF扩展(php-pdf)方式
若服务器已启用php-pdf扩展(基于PDFlib),可通过底层C函数直接构建PDF结构,性能高且内存占用低,但开发复杂度大,不推荐用于简单报表场景。
1、确认扩展已启用:在PHP配置中检查 extension=pdf.so(Linux)或 extension=php_pdf.dll(Windows)是否生效。
2、初始化PDF文档:调用 $pdf = pdf_new(); pdf_open_file($pdf, ''); pdf_set_info($pdf, 'Title', 'Report');。
3、设置字体资源:使用 $font = pdf_findfont($pdf, 'Helvetica', 'winansi', 0); pdf_setfont($pdf, $font, 12);。
4、绘制文本内容:调用 pdf_show_xy($pdf, '报表标题', 50, 750); 指定坐标位置输出文字。
5、结束文档并输出:执行 pdf_close($pdf); $data = pdf_get_buffer($pdf); header('Content-Type: application/pdf'); header('Content-Disposition: attachment; filename="report.pdf"'); echo $data;。



















