本文详细介绍了如何在Symfony 3.4应用中，将由Snappy PDF等工具生成的原始PDF字符串转换为服务器上的受密码保护的PDF文件。核心方法是利用Symfony的Process组件执行系统级的`q
pdf
`命令，从而实现PDF文件的写入、加密和读取，最终返回加密后的PDF内容，同时确保临时文件的妥善处理。
在Web开发中，尤其是在使用像Snappy PDF (基于wk
html
topdf) 这样的工具生成PDF文件时，我们经常会遇到其本身不提供直接的密码保护功能。当业务需求要求生成的PDF文件必须受密码保护时，一种常见的解决方案是在服务器端接收到PDF内容字符串后，将其写入临时文件，然后利用外部的命令行工具（如qpdf）对其进行加密处理，最后再读取加密后的文件内容进行后续操作。本文将以Symfony 3.4为例，详细阐述如何通过其强大的Process组件来完成这一任务。
1. 准备工作：安装qpdf工具
在开始之前，请确保您的Linux服务器上已经安装了qpdf工具。qpdf是一个功能强大的命令行工具，用于转换、检查和修改PDF文件，包括加密和解密。
通常，您可以通过包管理器进行安装：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
2. 将PDF字符串写入临时文件
由于qpdf是一个命令行工具，它需要操作实际的文件。因此，我们首先需要将Snappy PDF或其他服务返回的PDF内容字符串写入服务器上的一个临时文件。
我们将创建一个服务类来封装这些操作。
# Debian/Ubuntu 系统
sudo apt-get update
sudo apt-get install qpdf
# CentOS/RHEL 系统
sudo yum install qpdf
# 或者对于较新版本
sudo dnf install qpdf
projectDir = $projectDir;
}
/**
* 将原始PDF字符串转换为受密码保护的PDF字符串
*
* @param string $pdfContent 原始PDF内容的字符串
* @param string $password 用于保护PDF的密码
* @return string 受密码保护的PDF内容的字符串
* @throws \RuntimeException 如果PDF保护过程中的任何步骤失败
*/
public function protectPdfString(string $pdfContent, string $password): string
{
$fs = new Filesystem();
// 建议使用 /tmp 或应用可写目录下的子目录作为临时目录
$tempDir = $this->projectDir . '/var/temp_pdf/';
// 确保临时目录存在且可写
try {
if (!$fs->exists($tempDir)) {
$fs->mkdir($tempDir, 0777); // 确保目录权限可写
}
} catch (IOExceptionInterface $e) {
throw new \RuntimeException(sprintf('无法创建临时目录 "%s": %s', $tempDir, $e->getMessage()));
}
// 生成唯一的临时文件名
$inputFilePath = $tempDir . uniqid('unprotected_', true) . '.pdf';
$outputFilePath = $tempDir . uniqid('protected_', true) . '.pdf';
$protectedPdfContent = ''; // 初始化受保护的PDF内容
try {
// 1. 写入原始PDF内容到临时文件
if (file_put_contents($inputFilePath, $pdfContent) === false) {
throw new \RuntimeException(sprintf('无法写入原始PDF内容到文件 "%s"。请检查文件路径和权限。', $inputFilePath));
}
// ... (后续步骤将在这里