在开发过程中，有时我们需要对生成的 PDF 文档施加权限控制，例如禁止复制、打印或修改内容。mPDF 提供了 SetProtection 函数来实现这一目的。然而，许多开发者在使用此功能时会遇到困惑，尤其是在权限设置未能如预期生效时。本文将详细阐述 SetProtection 的正确用法，并解析其背后机制。
SetProtection 函数的工作原理
mPDF 的 SetProtection 函数主要用于对 PDF 文档进行加密，并在此基础上定义用户对文档的操作权限。其核心在于，文档的加密是权限生效的前提。如果没有设置密码来触发加密，即使指定了权限限制，大多数 PDF 阅读器也可能不会强制执行这些限制。
SetProtection 函数的完整签名如下：
SetProtection(array $permissions = array(), string $user_password = '', string $owner_password = '', int $security_level = 128)
-
$permissions (array): 这是一个字符串数组，用于指定允许用户执行的操作。如果此数组为空（array()），则表示在加密生效的情况下，不授予用户任何特定权限。这意味着所有未明确允许的操作（如复制、打印、修改等）都将被禁止。
- 常见的权限字符串包括：'print', 'copy', 'modify', 'annot-forms', 'fill-forms', 'extract', 'assemble', 'print-highres'。
- $user_password (string): 用户密码。如果设置此参数，用户在打开 PDF 文档时必须输入此密码。这是激活 PDF 加密和权限限制的关键。 如果未设置此密码，PDF 文档将不会被加密，并且 permissions 数组中的限制将不会被强制执行。
- $owner_password (string): 所有者密码。如果设置此参数，所有者可以使用此密码打开 PDF 文档，并获得文档的完全控制权限，不受 $permissions 数组的限制。
- $security_level (int): 安全级别，默认为 128 位加密。可选值为 40 或 128。
常见误区：SetProtection(array()) 不生效的原因
许多开发者在尝试禁止所有操作时，会直接调用 $mpdf->SetProtection(array());。然而，这种做法往往导致 PDF 文档仍然可以被复制和打印。
根本原因在于： 当 SetProtection(array()) 被调用时，由于没有提供 $user_password 或 $owner_password，mPDF 不会对 PDF 文档进行加密。一个未加密的 PDF 文档，其内部的权限设置（即使是空的 permissions 数组）对于 PDF 阅读器来说是可选的，大多数阅读器会选择忽略这些未加密的限制。
简而言之，没有密码就没有加密，没有加密就没有强制的权限限制。
正确的 PDF 文档保护实践
要有效禁止用户复制、打印或执行其他操作，您必须至少设置一个用户密码，从而触发 PDF 文档的加密。当加密生效后，$permissions 数组的作用才会被强制执行。
示例 1：禁止所有操作，并要求用户密码打开
如果您希望用户在打开文档时必须输入密码，并且在输入密码后，仍无法复制、打印或修改文档，可以这样设置：
<?php
require_once __DIR__ . '/vendor/autoload.php';
$mpdf = new \Mpdf\Mpdf();
// 设置保护：
// 第一个参数 array() 表示不授予任何特定权限
// 第二个参数 'UserPassword123' 是用户密码，用于打开文档
// 第三个参数 'OwnerPassword456' 是所有者密码，用于获取完全权限
$mpdf->SetProtection(array(), 'UserPassword123', 'OwnerPassword456');
// 设置文档元数据
$mpdf->SetTitle("受保护的文档");
$mpdf->SetAuthor('您的公司');
$mpdf->SetCreator('mPDF');
$mpdf->SetSubject('机密信息');
$mpdf->SetKeywords('安全, 机密, PDF');
// 添加内容
$html = '<h1>这是一个受保护的PDF文档</h1>
<p>您需要输入密码才能打开。即使打开后，也无法复制或打印。</p>
<p>此内容旨在演示mPDF的SetProtection功能。</p>';
$mpdf->WriteHTML($html);
// 输出 PDF
$fileName = 'ProtectedDocument_'.date('YmdHis').'.pdf';
$mpdf->Output($fileName, "D"); // "D" 表示下载文件
$mpdf->cleanup();
?>在上述代码中，由于 $permissions 数组为空，且提供了用户密码，生成的 PDF 文档将要求输入 UserPassword123 才能打开。打开后，用户将无法复制文本、打印文档或进行任何修改。
示例 2：允许打印，但禁止复制
如果您希望用户可以打印文档，但不能复制其中的内容，可以这样设置：
<?php
require_once __DIR__ . '/vendor/autoload.php';
$mpdf = new \Mpdf\Mpdf();
// 允许打印，但禁止复制（通过不包含 'copy' 权限）
$mpdf->SetProtection(array('print'), 'UserPasswordPrint', 'OwnerPasswordFull');
// ... 其他 mPDF 设置和内容 ...
$html = '<h1>这是一个可打印但不可复制的PDF文档</h1>
<p>您需要输入密码才能打开。打开后，可以打印但不能复制。</p>';
$mpdf->WriteHTML($html);
$fileName = 'PrintableButNotCopyable_'.date('YmdHis').'.pdf';
$mpdf->Output($fileName, "D");
$mpdf->cleanup();
?>注意事项与总结
- 密码是强制执行权限的关键： 务必记住，SetProtection 函数只有在设置了 $user_password (或 $owner_password，但用户密码更常见) 从而触发 PDF 加密后，才能有效强制执行权限限制。
- 权限数组的含义： $permissions 数组指定的是“允许”的操作。如果数组为空，则表示“不明确允许任何操作”，在加密生效的情况下，这等同于“禁止所有未明确允许的操作”。
- PDF 阅读器兼容性： 尽管 mPDF 生成的 PDF 遵循标准，但不同的 PDF 阅读器（尤其是旧版本或非标准阅读器）在处理权限限制时可能存在差异。始终建议在目标阅读器上进行测试。
- 调用时机： SetProtection 函数应在 WriteHTML 或 Output 之前调用，以确保保护设置在文档生成时即生效。
- 安全性考量： PDF 的权限保护并非绝对安全。有经验的用户或专业工具可能仍能绕过这些限制。对于高度敏感的信息，除了 PDF 保护外，还应考虑其他安全措施（如 DRM、服务器端访问控制等）。
通过理解 SetProtection 函数的参数及其与 PDF 加密机制的关联，您可以更准确地配置 mPDF 生成的 PDF 文档的权限，从而有效保护您的内容。
