DOMPDF在对PDF添加密码保护后，若先调用stream()再调用output()，会导致加密参数（尤其是p-value）被意外修改，造成后续下载的文件无法用正确密码打开。本文提供安全可靠的双重输出（浏览器流式下载 + 服务端保存）实现方案。
dompdf在对pdf添加密码保护后，若先调用`stream()`再调用`output()`，会导致加密参数（尤其是p-value）被意外修改，造成后续下载的文件无法用正确密码打开。本文提供安全可靠的双重输出（浏览器流式下载 + 服务端保存）实现方案。
在使用 DOMPDF 实现带密码保护的 PDF 生成时，一个常见却隐蔽的问题是：PDF 能正常通过 stream() 浏览器下载并用密码打开，但同一份文档若随后调用 output() 保存到服务器，再次下载该文件时却提示密码错误或解密失败。根本原因在于 DOMPDF 底层依赖的 CPDF（TCPDF 的轻量分支）在 stream() 过程中会动态修改加密对象中的 p 值（即权限标志位，RFC 3200 定义的 32 位整数），将其从原始值（如 252）转为补码形式（如 -4）。而该修改是不可逆的、仅作用于内存对象——当后续调用 output() 时，CPDF 会将已被篡改的 p 值写入 PDF 文件，导致加密结构不一致，Adobe Reader 等工具拒绝验证。
✅ 正确做法是：在 stream() 后手动恢复加密对象的原始信息，再执行 output()。以下是经过验证的健壮实现：
$dompdf = new Dompdf(['enable_remote' => true]);
$dompdf->loadHtml($html_print);
$dompdf->setPaper('A4', 'landscape');
$dompdf->render();
// 获取底层 CPDF 实例并设置加密
$cpdf = $dompdf->getCanvas()->get_cpdf();
$cpdf->setEncryption('user123', 'owner456', ['print', 'modify', 'copy', 'add']);
// 【关键】保存加密元数据快照（含原始 p-value）
$encryptionInfoBeforeStream = $cpdf->objects[$cpdf->arc4_objnum]['info'] ?? [];
// 输出至浏览器（触发 p-value 修改）
$dompdf->stream($filename . '.pdf');
// 【关键】还原加密元数据，确保 output() 写入正确值
if (!empty($encryptionInfoBeforeStream)) {
$cpdf->objects[$cpdf->arc4_objnum]['info'] = $encryptionInfoBeforeStream;
}
// 安全保存到服务器
$output = $dompdf->output();
$serverFilename = '../documents/' . $filename . '-' . time() . '.pdf';
file_put_contents($serverFilename, $output);
echo "PDF 已同时发送至浏览器并安全保存至服务器：{$serverFilename}";⚠️ 注意事项：
- 密码建议使用强字符串（如 openssl_random_pseudo_bytes(16) 生成），避免纯数字（如示例中的 1234/5678 仅作演示）；
- 权限数组 ['print', 'modify', ...] 必须严格匹配 DOMPDF 支持的选项，非法值可能导致加密静默失败；
- 若需支持中文密码，请确保 DOMPDF 版本 ≥ 2.0（旧版存在 UTF-8 编码缺陷）；
- 生产环境应配合 try/catch 捕获 DompdfException，并在 output() 前校验 $output 非空。
? 总结：DOMPDF 的密码保护本质是封装 CPDF 的 setEncryption()，其状态管理并非完全无副作用。通过“快照-流式输出-还原-保存”三步法，可彻底规避 p-value 被污染的问题，实现一次渲染、双重交付的稳定流程。
