【亲测免费】 TCPDF - PHP PDF 库使用教程

2026-01-30 04:11:20作者：谭伦延

1. 项目介绍

TCPDF 是一个 PHP 库，用于在服务器端动态生成 PDF 文档。它支持多种页面格式、自定义页面大小和边距、UTF-8 Unicode 以及从右到左的语言。TCPDF 提供了丰富的功能，包括 TrueTypeUnicode、OpenTypeUnicode、Type1 和 CID-0 字体的支持，字体子集、SVG、CSS、HTML、JavaScript 的处理，以及多种图像格式的支持。

2. 项目快速启动

首先，您需要通过 Composer 安装 TCPDF 库。

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

然后，使用 Composer 安装 TCPDF：

composer require tecnickcom/tc-lib-pdf

以下是一个生成 PDF 的简单示例：

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

// 创建新的 TCPDF 对象
$pdf = new \TCPDF();

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

// 设置字体
$pdf->SetFont('times', '', 12);

// 写入文本
$pdf->Write(0, 'Hello world!');

// 输出 PDF 文件
$pdf->Output('example.pdf', 'I');

3. 应用案例和最佳实践

生成带有 header 和 footer 的 PDF

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

$pdf = new \TCPDF();

// 设置文档信息
$pdf->SetAuthor('Your Name');
$pdf->SetTitle('TCPDF Example');

// 设置 header 和 footer
$pdf->setHeaderData('', 0, 'Example Header', 'Example Footer', array(0,64,255), array(0,64,128));
$pdf->setFooterData(array(0,64,0), array(0,64,128));

// 设置 header 和 footer 的字体
$pdf->setHeaderFont(Array('times', '', 10));
$pdf->setFooterFont(Array('times', '', 8));

// 设置默认的页边距
$pdf->SetMargins(15, 15, 15);

// 设置分页
$pdf->SetAutoPageBreak(TRUE, 15);

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

// 写入内容
$pdf->Write(0, 'Page 1 content...');

// 输出 PDF 文件
$pdf->Output('example_with_header_footer.pdf', 'I');

使用 HTML 内容生成 PDF

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

$pdf = new \TCPDF();

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

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

// 输入 HTML 内容
$html = <<<HTML
<h1>Example of HTML content</h1>
<p>This is a example of text in HTML format.</p>
HTML;

// 写入 HTML 内容
$pdf->writeHTML($html, true, false, true, false, '');

// 输出 PDF 文件
$pdf->Output('example_html.pdf', 'I');