SPIPU/HTML2PDF项目中的TCPDF方法详解

SPIPU/HTML2PDF项目中的TCPDF方法详解

【免费下载链接】html2pdf OFFICIAL PROJECT | HTML to PDF converter written in PHP 项目地址: https://gitcode.com/gh_mirrors/ht/html2pdf

前言

SPIPU/HTML2PDF是一个强大的PHP库，能够将HTML内容转换为PDF文档。它底层基于TCPDF引擎，这意味着开发者可以直接调用TCPDF的各种方法来增强PDF生成功能。本文将详细介绍如何在SPIPU/HTML2PDF中使用TCPDF的核心方法。

如何访问TCPDF方法

在SPIPU/HTML2PDF中，所有TCPDF方法都可以通过pdf属性来调用：

$html2pdf->pdf->方法名();

这种设计使得开发者能够充分利用TCPDF的全部功能，同时享受HTML2PDF提供的便捷HTML转换能力。

显示模式设置

SetDisplayMode方法允许你控制PDF文档在查看器中的显示方式：

$html2pdf->pdf->SetDisplayMode('fullpage', 'TwoColumnLeft', 'UseOutlines');

参数详解

1. 缩放模式($zoom)：

   • fullpage：整页显示
   • fullwidth：最大宽度显示
   • real：实际大小(100%缩放)
   • default：使用查看器默认模式
   • 也可以直接指定数字缩放比例(如1.5表示150%缩放)

2. 页面布局($layout)：

   • SinglePage：单页显示
   • OneColumn：单列显示
   • TwoColumnLeft：双列显示，奇数页在左
   • TwoColumnRight：双列显示，奇数页在右
   • TwoPageLeft：双页显示，奇数页在左(PDF 1.5+)
   • TwoPageRight：双页显示，奇数页在右(PDF 1.5+)

3. 显示模式($mode)：

   • UseNone：不显示文档大纲或缩略图
   • UseOutlines：显示文档大纲
   • UseThumbs：显示缩略图
   • FullScreen：全屏模式
   • UseOC：显示可选内容面板(PDF 1.5+)
   • UseAttachments：显示附件面板(PDF 1.6+)

文档信息设置

你可以为PDF文档设置各种元信息，这些信息会显示在PDF阅读器的文档属性中：

$html2pdf->pdf->SetAuthor('张三');
$html2pdf->pdf->SetTitle('项目报告');
$html2pdf->pdf->SetSubject('2023年度项目总结');
$html2pdf->pdf->SetKeywords('报告, 年度, 项目, 2023');

这些设置不仅有助于文档管理，还能提升PDF文档在搜索引擎中的可发现性。

文档保护设置

SetProtection方法可以为PDF文档添加安全保护：

$html2pdf->pdf->SetProtection(
    ['print', 'copy'],  // 允许打印和复制
    'user123',         // 用户密码
    'owner456',        // 所有者密码
    2                  // AES 128位加密
);

保护参数详解

1. 权限控制($permissions)：

   • print：允许打印
   • modify：允许修改内容
   • copy：允许复制内容
   • annot-forms：允许添加注释和表单
   • fill-forms：允许填写表单
   • extract：允许提取内容
   • assemble：允许文档重组
   • print-high：允许高质量打印
   • owner：(公钥专用)允许更改加密设置

2. 密码设置：

   • $userPass：用户密码(打开文档需要)
   • $ownerPass：所有者密码(控制权限需要)，默认随机生成

3. 加密强度($mode)：

   • 0：RC4 40位(弱)
   • 1：RC4 128位
   • 2：AES 128位(推荐)
   • 3：AES 256位(最强)

4. 公钥加密($pubkeys)： 允许使用公钥证书进行加密，适合需要为多个接收者设置不同权限的场景。

最佳实践建议

1. 显示模式选择：

   • 对于长文档，推荐使用TwoColumnLeft布局
   • 技术文档适合使用UseOutlines模式，方便导航
   • 演示文档可以考虑FullScreen模式

2. 文档保护：

   • 敏感文档建议使用AES 256位加密
   • 仅设置必要的权限，避免过度限制
   • 定期更换密码，特别是所有者密码

3. 元信息设置：

   • 为所有文档设置完整的元信息
   • 关键词要准确反映文档内容
   • 作者信息使用标准格式(如"姓 名")

总结

通过SPIPU/HTML2PDF的pdf属性，开发者可以充分利用TCPDF的强大功能，从基本的显示设置到高级的安全保护，为生成的PDF文档提供全方位的定制能力。合理运用这些方法，可以显著提升PDF文档的专业性和安全性。

【免费下载链接】html2pdf OFFICIAL PROJECT | HTML to PDF converter written in PHP 项目地址: https://gitcode.com/gh_mirrors/ht/html2pdf