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 字体文件。
添加中文字体的方法如下：
- 使用
addFont()方法注册字体：
$pdf->addFont('simhei', '', 'simhei.ttf', true);- 在设置字体时使用它：
$pdf->SetFont('simhei', '', 12);提示： 字体文件 simhei.ttf 需要放在正确路径下，并确保该路径可读。你可以从系统字体目录或网络下载后放入项目资源目录。
添加图片、表格和页眉页脚
TCPDF 还支持插入图片、绘制表格以及设置页眉页脚，这些功能在生成正式文档时非常有用。
插入图片：
$pdf->Image('logo.png', 15, 40, 30, 0, 'PNG');参数分别是：图片路径、X 坐标、Y 坐标、宽度、高度、图片类型。
绘制表格：
使用 HTML 格式配合 writeHTML() 方法：
$html = '
| 姓名 | 年龄 |
|---|---|
| 张三 | 28 |
这种方式适合结构化数据展示。
设置页眉和页脚：
继承 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 文件了。
