在 TCPDF 中使用 Base64 图像

TCPDF 是一款用于创建 PDF 文档的 PHP 类库。在创建 PDF 文档时，我们可能需要添加一些图片，而这些图片可能需要先转换为 Base64 格式。本文将介绍如何在 TCPDF 中使用 Base64 图像。

1. 将图片转换为 Base64 格式

在使用 Base64 图像之前，我们需要先将图片转换为 Base64 格式。PHP 自带了一个函数 base64_encode() 用于将字符串转换为 Base64 格式，我们只需要读取图片文件并将文件内容传入该函数即可。

$img = file_get_contents('path/to/image.jpg');
$img_base64 = base64_encode($img);

2. 在 TCPDF 中使用 Base64 图像

在 TCPDF 中，我们可以使用 Image() 方法添加图片。Image() 方法支持多种图片格式，包括 JPEG、PNG、GIF、BMP 等。而对于 Base64 图像，我们需要添加一个参数 $imgtype 来指定图像格式。

$pdf = new TCPDF();

// 添加 Base64 图像
$img_base64 = 'data:image/jpeg;base64,/9j/4AAQSkZJRg...';  // Base64 编码的 JPEG 图像
$pdf->Image($img_base64, $x, $y, $w, $h, $imgtype='', $link='', $align='', $resize=false, $dpi=300, $palign='', $border=0, $fitbox=false, $hidden=false, $fitonpage=false);

$pdf->Output();

参数说明：

• $img_base64：Base64 图像数据
• $x：图片左上角在页面上的 X 坐标
• $y：图片左上角在页面上的 Y 坐标
• $w：图片宽度
• $h：图片高度
• $imgtype：图像格式，如 jpeg、png、gif、bmp 等
• $link：图片链接
• $align：对齐方式，如 L、C、R 等
• $resize：是否自适应大小
• $dpi：分辨率
• $palign：对齐方式，如 L、C、R 等
• $border：边框宽度
• $fitbox：是否自适应大小
• $hidden：是否隐藏
• $fitonpage：是否自适应页面大小

3. 示例代码

下面是一个完整的示例代码，演示如何在 TCPDF 中使用 Base64 图像。

require_once 'tcpdf/tcpdf.php';

// 读取图片并编码为 Base64
$img = file_get_contents('path/to/image.jpg');
$img_base64 = base64_encode($img);
$img_type = 'jpeg';

// 创建 PDF 对象
$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);

// 设置文档信息
$pdf->SetCreator(PDF_CREATOR);
$pdf->SetAuthor('John Doe');
$pdf->SetTitle('TCPDF Example');
$pdf->SetSubject('TCPDF Tutorial');
$pdf->SetKeywords('TCPDF, PDF, example, test, guide');

// 设置页面边距
$pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);

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

// 添加 Base64 图像
$pdf->Image($img_base64, 10, 10, 50, 50, $img_type);

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

4. 总结

本文介绍了如何在 TCPDF 中使用 Base64 图像。通过将图片转换为 Base64 格式，我们可以避免在 PDF 文件中添加额外的图片文件。Base64 图像也更容易传输和嵌入到 HTML 文件中。如果您需要创建包含图片的 PDF 文档，TCPDF 是一个不错的选择，它支持多种图片格式，并且可以轻松添加 Base64 图像。