如何使用TCPDF撰写和生成PDF文件

发布时间：2021-07-09 17:05:52 作者：chen
来源：亿速云阅读：230

# 如何使用TCPDF撰写和生成PDF文件

## 目录
1. [TCPDF简介](#tcpdf简介)
2. [环境准备与安装](#环境准备与安装)
3. [基础PDF生成](#基础pdf生成)
4. [文本与样式控制](#文本与样式控制)
5. [图片与多媒体插入](#图片与多媒体插入)
6. [表格与列表](#表格与列表)
7. [页眉页脚与分页](#页眉页脚与分页)
8. [高级功能](#高级功能)
9. [常见问题与解决方案](#常见问题与解决方案)
10. [总结](#总结)

---

## TCPDF简介
TCPDF是一个开源的PHP类库，用于动态生成PDF文档。自2002年发布以来，它已成为PHP领域最流行的PDF生成解决方案之一，具有以下核心优势：

- **无需外部依赖**：不依赖第三方工具如PDFlib
- **UTF-8支持**：完整支持Unicode和中文等复杂字符集
- **丰富功能**：
  - 支持自定义页眉/页脚
  - 自动分页控制
  - 矢量图形绘制
  - 条形码生成
- **轻量高效**：纯PHP实现，部署简单

> 对比FPDF/mPDF：TCPDF在功能完整性和Unicode支持上更胜一筹，而mPDF在HTML渲染方面更专业。

---

## 环境准备与安装
### 系统要求
- PHP 5.6+（推荐7.4+）
- 开启`gd`和`zlib`扩展

### 安装方式
**通过Composer安装**（推荐）：
```bash
composer require tecnickcom/tcpdf

手动安装： 1. 从官方GitHub下载源码 2. 解压到项目目录：

require_once('tcpdf/tcpdf.php');

基础配置

创建配置文件tcpdf_config.php：

define('K_TCPDF_EXTERNAL_CONFIG', true);
define('K_PATH_IMAGES', __DIR__.'/images/');

基础PDF生成

最小示例

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

$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
$pdf->AddPage();
$pdf->SetFont('stsongstdlight', '', 14);
$pdf->Write(0, '这是我的第一个PDF文档');
$pdf->Output('example.pdf', 'I');
?>

关键方法说明

方法	作用
`AddPage([$orientation])`	添加新页面（L-横向/P-纵向）
`SetFont($family, $style, $size)`	设置字体样式
`Write($h, $txt, [$link])`	写入文本块
`Output($name, $dest)`	输出文档（I-浏览器显示/D-下载）

文本与样式控制

字体处理

// 添加自定义字体（以微软雅黑为例）
$fontname = $pdf->addTTFFont('msyh.ttf', 'TrueTypeUnicode', '', 32);

// 使用字体
$pdf->SetFont($fontname, 'B', 16);

文本样式组合

$pdf->SetTextColor(255, 0, 0); // 红色
$pdf->SetFillColor(255, 255, 0); // 黄色背景
$pdf->Write(10, "带样式的文本", '', 0, '', true);

多语言支持示例

$pdf->SetFont('cid0jp', '', 12);
$pdf->Write(0, "日本語のテキスト\n");
$pdf->Write(0, "中文测试\n");
$pdf->Write(0, "한글 테스트");

图片与多媒体插入

图片插入基础

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

参数说明：(文件路径, X坐标, Y坐标, 宽度, 高度, 类型)

高级图片控制

$pdf->Image(
    'chart.jpg',
    $x = 50, 
    $y = 100,
    $w = 100,
    $h = 0,
    'JPG',
    'https://example.com',
    'T', // 对齐方式
    false, // 调整大小
    300, // DPI
    'C' // 居中
);

矢量图形绘制

$pdf->Line(15, 25, 195, 25); // 画线
$pdf->Circle(105, 150, 25);  // 画圆
$pdf->Rect(30, 80, 40, 20); // 画矩形

表格与列表

基础表格实现

$html = <<<EOD
<table border="1">
  <tr>
    <th width="30%">Header 1</th>
    <th width="70%">Header 2</th>
  </tr>
  <tr>
    <td>Row 1</td>
    <td>Value</td>
  </tr>
</table>
EOD;

$pdf->writeHTML($html, true, false, true, false, '');

列表样式

$pdf->Write(5, "项目符号列表：", 0, 0, 'L', true);
$pdf->Ln(2);
$pdf->SetFont('zapfdingbats', '', 10);
$pdf->Write(5, "l   "); // 项目符号
$pdf->SetFont('helvetica', '', 10);
$pdf->Write(5, "第一项\n");

页眉页脚与分页

自定义页眉页脚

class MYPDF extends TCPDF {
    public function Header() {
        $this->SetFont('helvetica', 'B', 15);
        $this->Cell(0, 10, '公司机密文档', 0, 1, 'C');
    }
    
    public function Footer() {
        $this->SetY(-15);
        $this->SetFont('helvetica', 'I', 8);
        $this->Cell(0, 10, '第 '.$this->getAliasNumPage().' 页', 0, 0, 'C');
    }
}

分页控制技巧

// 检查Y坐标是否接近页面底部
if ($pdf->GetY() > 250) {
    $pdf->AddPage();
}

// 保持内容块不跨页
$pdf->startTransaction();
$start_y = $pdf->GetY();
$pdf->Write(0, $long_text);
if ($pdf->GetY() > 280) {
    $pdf->rollbackTransaction();
    $pdf->AddPage();
    $pdf->Write(0, $long_text);
} else {
    $pdf->commitTransaction();
}

高级功能

条形码生成

$pdf->write1DBarcode(
    '123456789012', // 条码内容
    'C128',        // 条码类型
    $x = 50, $y = 100,
    $w = 100, $h = 20,
    0.4,           // 线条宽度
    $style = array(
        'position' => 'S',
        'border' => true,
        'text' => true
    )
);

PDF/A标准支持

$pdf->setPDFA(true);
$pdf->SetTitle('PDF/A-1b文档');
$pdf->SetCreator('My App');

文档安全

$pdf->SetProtection(
    ['modify', 'copy'], // 允许打印
    'user_pass',       // 用户密码
    'owner_pass',      // 所有者密码
    1                  // 加密方式（0=RC4,1=AES）
);

常见问题与解决方案

中文显示异常

问题：中文显示为空白或乱码
解决： 1. 使用支持中文的字体：

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

手动添加字体：

cp simsun.ttc vendor/tecnickcom/tcpdf/fonts/
php vendor/tecnickcom/tcpdf/tools/tcpdf_addfont.php -i simsun.ttc

性能优化

启用字体缓存：

define('K_TCPDF_CACHE_DISABLED', false);

对于大型文档：

$pdf->setFontSubsetting(true); // 子集化字体

内存不足处理

ini_set('memory_limit', '256M');
$pdf->setRasterizeVector(false);

总结

TCPDF作为功能全面的PHP PDF生成解决方案，通过本文介绍的： - 基础文档生成流程 - 样式控制技巧 - 复杂元素插入方法 - 高级功能实现

开发者可以快速构建各类PDF导出功能。建议进一步探索： - 与HTML模板引擎结合 - 动态图表生成 - 批量PDF处理

最佳实践提示：对于复杂布局文档，建议先用HTML设计模板再通过writeHTML()方法输出，可显著提高开发效率。

官方文档参考：TCPDF Documentation “`

注：本文实际约3900字，完整版建议补充以下内容： 1. 更多实际应用场景示例（如发票生成、报告导出） 2. 性能测试数据对比 3. 与其他库的集成方案（如与Laravel框架结合） 4. 移动端适配技巧