PDF生成与处理教程：TCPDF库使用全攻略

TCPDF 是一个功能强大的 PHP 开源库，适合用于生成发票、报告等 PDF 文件。1. 通过 Composer 安装并引入 TCPDF；2. 实例化类并添加页面、设置字体、写入内容、输出文档；3. 添加中文字体支持需使用 addFont() 方法并正确设置路径；4. 支持插入图片、用 HTML 表格格式绘制表格；5. 继承 TCPDF 类重写 Header 和 Footer 方法可设置页眉页脚。掌握这些核心步骤能帮助你高效实现 PDF 生成与样式控制。

PDF文件的生成和处理在很多项目中都是常见的需求，比如生成发票、报告、合同等。TCPDF 是一个功能强大的 PHP 开源库，可以用来创建 PDF 文档，支持中文、自定义字体、表格、图像等多种内容。如果你正在寻找一个稳定且灵活的方案来实现 PDF 生成，TCPDF 是个不错的选择。

下面是一个实用性的使用教程，帮助你快速上手 TCPDF 的基本操作和常见问题处理。

安装与引入 TCPDF

要使用 TCPDF，首先需要把它集成到你的 PHP 项目中。最简单的方式是通过 Composer 安装：

composer require tecnickcom/tcpdf

安装完成后，在你的 PHP 文件中引入自动加载文件即可：

require_once('vendor/autoload.php');

这样就可以开始使用 TCPDF 提供的类和方法了。

注意： 如果你没有使用 Composer，也可以手动下载 TCPDF 源码包并 include 相关文件，但推荐使用 Composer 管理依赖。

创建第一个 PDF 文档

接下来我们来创建一个最基础的 PDF 文件，包含标题和一段文字。

$pdf = new TCPDF();
$pdf->AddPage();
$pdf->SetFont('helvetica', '', 12);
$pdf->Write(0, '这是一个使用 TCPDF 生成的 PDF 示例文档。');
$pdf->Output('example.pdf', 'I'); // 输出方式：I 浏览器直接显示，D 下载文件

上面代码的关键点：

• 实例化 TCPDF 类
• 添加页面（AddPage）
• 设置字体（SetFont）
• 写入内容（Write）
• 输出文档（Output）

其中 Output 方法的第二个参数决定了输出行为：

• I：浏览器中预览
• D：强制下载
• F：保存到服务器
• S：返回字符串

支持中文与自定义字体

默认情况下，TCPDF 不支持中文。为了让生成的 PDF 能正常显示中文，你需要添加中文字体。TCPDF 自带了一些字体，也可以自己导入 TTF 字体文件。

添加中文字体的方法如下：

1. 使用 addFont() 方法注册字体：

$pdf->addFont('simhei', '', 'simhei.ttf', true);

2. 在设置字体时使用它：

$pdf->SetFont('simhei', '', 12);

提示： 字体文件 simhei.ttf 需要放在正确路径下，并确保该路径可读。你可以从系统字体目录或网络下载后放入项目资源目录。

添加图片、表格和页眉页脚

TCPDF 还支持插入图片、绘制表格以及设置页眉页脚，这些功能在生成正式文档时非常有用。

插入图片：

$pdf->Image('logo.png', 15, 40, 30, 0, 'PNG');

参数分别是：图片路径、X 坐标、Y 坐标、宽度、高度、图片类型。

绘制表格：

使用 HTML 格式配合 writeHTML() 方法：

$html = '

            
姓名
年龄
            
张三
28
         
';
$pdf->writeHTML($html, true, false, true, false, '');

这种方式适合结构化数据展示。

设置页眉和页脚：

继承 TCPDF 并重写 Header 和 Footer 方法：

class MYPDF extends TCPDF {
    public function Header() {
        $this->SetFont('simhei', '', 10);
        $this->Cell(0, 10, '这是页眉', 0, false, 'C', 0, '', 0, false, 'M', 'M');
    }

    public function Footer() {
        $this->SetY(-15);
        $this->SetFont('helvetica', 'I', 8);
        $this->Cell(0, 10, '第 '.$this->getAliasNumPage().' 页 / 共 '.$this->getAliasTotalPages().' 页', 0, false, 'C');
    }
}

然后用这个子类代替原始的 TCPDF 即可：

$pdf = new MYPDF();

基本上就这些常用功能了。TCPDF 功能很全，但也有些细节容易踩坑，比如字体路径、编码问题、样式错位等。建议多看官方示例文档，遇到问题先查是否已有解决方案。掌握了这些核心技巧，你就能在自己的项目中灵活运用 TCPDF 来生成各种 PDF 文件了。