当前位置：首页 > 文章列表 > 文章 > php教程 > PHP生成PDF？这3种主流库你用过几种？

PHP生成PDF？这3种主流库你用过几种？

2025-06-14 09:58:24 0浏览收藏

想用PHP生成PDF文件？选对库很关键！本文为你解析三种主流PHP PDF库：TCPDF、FPDF和mPDF，助你高效生成PDF文档。TCPDF功能强大，支持水印、加密等高级特性，但API复杂；FPDF轻量易用，适合简单报表，但对UTF-8支持有限；mPDF则擅长HTML转PDF，方便前端开发者，处理中文也更得心应手。面对中文乱码问题，各库有不同解决方案，而添加图片则可通过Image()方法或HTML标签实现。此外，本文还分享了避免内存溢出的实用技巧。选择哪个库？取决于你的项目复杂度、功能需求和对中文的支持程度。

PHP生成PDF的常用库有TCPDF、FPDF和mPDF，选择取决于具体需求。1. TCPDF功能强大，支持水印、加密、自定义字体等高级特性，适合复杂文档，但性能较弱，API复杂；2. FPDF轻量易用，适合简单报表，但不支持UTF-8和复杂布局；3. mPDF支持HTML和CSS，适合前端开发者，处理中文方便，但体积大、性能较低。若需处理中文乱码，TCPDF应使用UTF-8编码及自定义字体，FPDF需转换编码或用扩展，mPDF则设置正确字体即可。添加图片方面，TCPDF和FPDF用Image()方法，mPDF可在HTML中插入img标签。为避免内存溢出，可分批生成内容、优化数据库查询或调整PHP内存限制。综上，根据项目复杂度、功能需求及中文处理等因素选择合适的库，以实现高效PDF生成。

PHP怎样生成PDF文件 PHP生成PDF的3种常用库对比

生成PDF文件，PHP有很多选择。最常见的做法是借助第三方库，各有优劣，选哪个得看你的具体需求和项目复杂度。

解决方案

PHP生成PDF，主流的方案就是使用PDF库。这里对比三个比较常用的库：TCPDF、FPDF和mPDF。

1. TCPDF:

TCPDF算是个老牌选手了，功能非常全面，支持各种复杂的PDF特性，比如水印、加密、自定义字体等等。它最大的优点是免费开源，而且文档也比较完善。

优点:
- 功能强大，支持各种高级PDF特性。
- 免费开源。
- 文档详细，社区支持良好。
- 支持UTF-8，处理中文方便。
缺点:
- 相对来说，性能可能不如其他库。
- API比较复杂，上手可能需要一些时间。

示例代码:

<?php
require_once('tcpdf/tcpdf.php');

// 创建新的PDF文档
$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('TCPDF Example');
$pdf->SetSubject('TCPDF Example');
$pdf->SetKeywords('TCPDF, PDF, example, test, guide');

// 设置页眉和页脚
$pdf->SetHeaderData(PDF_HEADER_LOGO, PDF_HEADER_LOGO_WIDTH, PDF_HEADER_TITLE.' 001', PDF_HEADER_STRING, array(0,64,255), array(0,64,127));
$pdf->setFooterData(array(0,64,0), array(0,64,127));

// 设置页眉和页脚字体
$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);

// 添加字体
if (@file_exists(dirname(__FILE__).'/lang/eng.php')) {
    require_once(dirname(__FILE__).'/lang/eng.php');
    $pdf->setLanguageArray($l);
}

// 添加一页
$pdf->AddPage();

// 设置字体
$pdf->SetFont('dejavusans', '', 10);

// 输出内容
$html = '<h1>Welcome to TCPDF!</h1><p>This is an example of using TCPDF to generate PDF documents.</p>';
$pdf->writeHTML($html, true, false, true, false, '');

// 输出PDF
$pdf->Output('example_001.pdf', 'I');
?>

2. FPDF:

FPDF以轻量级著称，它的特点是简单易用，体积小巧。如果你只需要生成一些简单的PDF文档，比如发票、报表之类的，FPDF是个不错的选择。但它对复杂布局的支持相对较弱。

优点:
- 轻量级，体积小。
- 简单易用，上手快。
缺点:
- 功能相对简单，不支持复杂的PDF特性。
- 不支持UTF-8，处理中文需要一些技巧。

示例代码:

<?php
require('fpdf/fpdf.php');

$pdf = new FPDF();
$pdf->AddPage();
$pdf->SetFont('Arial','B',16);
$pdf->Cell(40,10,'Hello World!');
$pdf->Output('hello.pdf','D');
?>

3. mPDF:

mPDF的优势在于它支持HTML和CSS，你可以直接用HTML代码来生成PDF，这对于熟悉前端开发的同学来说非常友好。它内部使用了HTML解析器，能够将HTML代码转换成PDF文档。

优点:
- 支持HTML和CSS，可以使用HTML代码生成PDF。
- 对中文支持良好。
缺点:
- 性能可能不如FPDF。
- 体积相对较大。

示例代码:

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

$mpdf = new \Mpdf\Mpdf();
$mpdf->WriteHTML('<h1>Hello world!</h1>');
$mpdf->Output('my_document.pdf', 'D');
?>

如何选择合适的PHP PDF库？

选择哪个库，主要看你的需求。

简单报表、发票: FPDF足矣，简单快速。
复杂排版、高级特性: TCPDF更合适，功能全面。
HTML转PDF: mPDF是首选，方便快捷。

PHP生成PDF时中文乱码怎么办？

中文乱码是PHP生成PDF时常见的问题。解决方法取决于你使用的库。

TCPDF: TCPDF对UTF-8支持良好，确保你的PHP文件和HTML内容都使用UTF-8编码，然后使用TCPDF提供的字体即可。例如$pdf->SetFont('dejavusans', '', 10);
FPDF: FPDF原生不支持UTF-8，需要使用一些技巧，比如使用iconv函数将UTF-8编码转换为FPDF支持的编码，或者使用一些扩展库。
mPDF: mPDF对中文支持较好，通常情况下只需要设置正确的字体即可。