mPDF库提供setProtection函数以实现PDF文档的安全加密与权限控制。本文旨在纠正setProtection(Array())无法生效的常见误区，并详细阐述如何正确配置权限数组、用户密码及所有者密码，从而有效限制PDF的打印、复制等操作。通过掌握其完整用法，开发者可为生成的PDF文件提供可靠的安全保障。
引言：mPDF PDF安全防护的常见误区
在使用mPDF生成PDF文件时，开发者常会尝试利用SetProtection()函数来限制用户对PDF内容的复制、打印等操作。然而，一个常见的误解是，简单地调用$mpdf->SetProtection(array());就能够实现预期的保护效果。实际上，当不设置任何密码时，PDF文档并不会被加密，因此，即使指定了权限数组，这些权限也无法被PDF阅读器有效强制执行，导致用户仍然可以自由复制或打印文件内容。要使SetProtection函数生效，其核心在于激活PDF的加密机制，这通常需要设置至少一个用户密码或所有者密码。
理解 SetProtection 函数的核心机制
SetProtection 函数是mPDF库中用于控制PDF文档安全设置的关键方法。其完整签名如下：
public function SetProtection(array $permissions = array(), string $user_password = '', string $owner_password = '', int $encryption_type = 128)
下面我们逐一解析其参数：
1. 权限数组 ($permissions)
这是一个字符串数组，用于指定允许用户执行的操作。当PDF被加密后，这些权限才会被强制执行。常见的权限包括：
- copy: 允许复制文本和图像。
- print: 允许打印文档。
- modify: 允许修改文档内容（例如添加或删除页面）。
- annot-forms: 允许添加或修改注释和填写表单字段。
- fill-forms: 仅允许填写表单字段。
- extract: 允许提取文本和图像（与copy类似，但可能更广义）。
- assemble: 允许插入、旋转或删除页面，以及创建书签或缩略图。
- print-highres: 允许高分辨率打印。
如果此数组为空（array()），且文档已通过密码加密，则意味着用户在打开文档后，将不允许执行任何上述操作。
2. 用户密码 ($user_password)
这是一个字符串，用于设置打开PDF文档所需的密码。如果设置了用户密码，用户必须输入此密码才能查看PDF内容。如果未设置（为空字符串），则文档无需密码即可打开。
3. 所有者密码 ($owner_password)
这是一个字符串，用于设置所有者的密码。所有者密码通常拥有比用户密码更高的权限，即使在$permissions数组中禁止了某些操作，所有者使用此密码打开文档后，也可以绕过这些限制，获得文档的完全控制权。如果未设置（为空字符串），则所有者不具备特殊权限。
4. 加密类型 ($encryption_type)
这是一个整数，指定PDF的加密算法强度。mPDF支持两种主要的加密类型：
- 40: 40位RC4加密（较旧，安全性较低）。
- 128: 128位AES加密（默认值，推荐使用，安全性更高）。
通常情况下，使用默认的128即可。
SetProtection 的正确使用方法
要确保SetProtection函数能够有效限制PDF操作，关键在于提供至少一个密码（用户密码或所有者密码）以激活PDF的加密功能。一旦PDF被加密，权限数组的设置才能真正生效。
以下是实现PDF加密与权限控制的示例代码，基于原始问题的解决方案进行优化：
<?php require_once __DIR__ . '/vendor/autoload.php'; // 确保mPDF库已通过composer加载 // 创建mPDF实例 $mpdf = new MpdfMpdf(); // ============================================== // 核心安全设置：在生成内容之前调用 SetProtection // ============================================== // 示例1：加密文件，用户需输入密码打开，打开后无任何权限（不能复制、打印等） // 所有者使用另一个密码打开可获得完全权限 $userPassword = 'UserPassword'; // 用户密码 $ownerPassword = 'MyPassword'; // 所有者密码 $mpdf->SetProtection(array(), $userPassword, $ownerPassword, 128); // 原始代码中的其他设置，这些通常在 SetProtection 之后 $mpdf->SetTitle("Quorum sine causa fieri nihil"); $mpdf->SetAuthor('Quorum sine causa fieri nihil'); $mpdf->SetCreator('Quorum sine causa fieri nihil'); $mpdf->SetSubject('Quorum sine causa fieri nihil'); $mpdf->SetKeywords('Quorum sine causa fieri nihil'); // 加载css $css = file_get_contents(__DIR__. '/assets/css/mpdf.css'); $mpdf->WriteHTML($css, MpdfHTMLParserMode::HEADER_CSS); // 假设 $html 变量包含你的HTML内容 $html = ' <h1>PDF安全测试</h1> <p>这是一段受保护的PDF内容。如果您使用用户密码打开，将无法复制或打印。</p> <p>只有使用所有者密码打开，才能获得完全权限。</p> '; $mpdf->WriteHTML($html, MpdfHTMLParserMode::HTML_BODY); // 生成PDF文件名 $order_id = 'ORD12345'; // 示例订单ID $fileName = 'Invoice_' . date('D-d-m-Y-H-i-s') . '_' . $order_id . '.pdf'; // 输出PDF到浏览器下载 $mpdf->Output($fileName, "D"); // 清理资源 (可选，通常在脚本结束时自动清理) $mpdf->cleanup(); ?>
解释：
在上述示例中，$mpdf->SetProtection(array(), $userPassword, $ownerPassword, 128); 的作用是：
- 加密PDF文件：由于提供了$userPassword和$ownerPassword，mPDF将对生成的PDF文件进行加密。
- 用户权限：array()表示用户在输入$userPassword成功打开文档后，将不允许执行任何在权限数组中列出的操作。这意味着用户无法复制文本、打印、修改等。
- 所有者权限：所有者可以使用$ownerPassword打开文档，并获得完全的控制权限，即使权限数组禁止了某些操作。
不同安全需求下的配置示例
根据不同的安全需求，您可以灵活配置SetProtection函数的参数：
1. 限制复制与打印，需密码打开
这是最常见的需求。用户需要密码才能打开文档，打开后无法复制或打印。
// 用户需输入 'user123' 打开，打开后无法复制、无法打印 // 所有者输入 'owner456' 可获得完全权限 $mpdf->SetProtection(array(), 'user123', 'owner456');
这里的array()表示用户在打开文档后，不被授予任何特定的权限，因此默认是禁止复制、打印等操作的。
2. 允许打印，限制复制，需密码打开
如果希望用户能够打印文档，但不能复制其内容。
// 用户需输入 'user123' 打开，打开后可以打印，但不能复制 // 所有者输入 'owner456' 可获得完全权限 $mpdf->SetProtection(array('print'), 'user123', 'owner456');
这里的array(‘print’)表示用户在打开文档后，被明确授予了打印权限，但没有授予其他权限（如复制）。
3. 仅限制部分权限（不推荐无密码下使用）
如前所述，如果不设置任何密码，PDF将不会被加密，因此SetProtection函数中的权限设置将无法被强制执行。例如：
// 这种写法将不会生效，因为没有密码，PDF未加密 // $mpdf->SetProtection(array('copy', 'print'));
重要提示： 除非您设置了至少一个密码，否则SetProtection函数中的权限数组将不会有任何实际效果。PDF的安全机制依赖于加密层来强制执行权限。
注意事项与局限性
- 加密是基础：SetProtection函数的核心是PDF的加密。没有密码（用户密码或所有者密码）的设置，权限控制将形同虚设。
- PDF阅读器兼容性：mPDF设置的PDF安全特性符合PDF标准。大多数主流的PDF阅读器（如adobe acrobat reader, Foxit Reader, Evince等）都会尊重这些权限设置。然而，一些非标准或恶意的PDF阅读器可能选择忽略这些设置。
- 安全并非绝对：PDF的软件级安全措施并非无法被破解。有经验的用户或专业工具可能能够绕过这些保护。对于极度敏感的文档，可能需要结合更强大的DRM（数字版权管理）解决方案或服务器端渲染/查看机制。
- 密码管理：选择强密码并妥善管理至关重要。弱密码容易被猜测或暴力破解。
总结
mPDF的SetProtection函数是实现PDF文档基本安全防护的强大工具。其关键在于理解加密是权限控制的前提。通过正确配置用户密码、所有者密码以及权限数组，开发者可以有效地限制用户对PDF文件的访问和操作，如禁止复制、打印或修改。务必记住，当需要强制执行任何权限时，至少要设置一个用户密码或所有者密码来激活PDF的加密功能。掌握这些要点，将能帮助您更好地利用mPDF创建安全、受控的PDF文档。
