PHP可通过调用本地Pandoc实现Markdown/HTML转PDF/DOCX，需先验证Pandoc可用性，再选用exec、proc_open、临时文件或封装类等安全方式执行转换。
如果您在PHP项目中需要将Markdown、HTML等格式文档转换为PDF、DOCX等目标格式，而本地已安装Pandoc命令行工具，则可通过PHP进程调用实现自动化转换。以下是具体实施步骤：
一、确认Pandoc安装与环境可执行性
该步骤确保PHP运行用户具备调用系统命令的权限，且Pandoc二进制文件位于系统PATH中或可被绝对路径访问。缺少此前提，后续所有调用均会失败。
1、在终端执行 pandoc --version，验证是否输出版本号（如3.1.10）。
2、在PHP中执行 exec('which pandoc', $output, $returnCode)，检查 $returnCode 是否为0，且 $output[0] 返回非空路径。
3、若返回空或报错，需使用绝对路径替代，例如 /usr/local/bin/pandoc 或 C:\Program Files\Pandoc\pandoc.exe。
二、使用exec函数执行基础转换命令
该方法适用于单次、轻量级转换任务，直接捕获标准输出与错误流，便于快速调试和结果获取。
1、构造命令字符串，例如将input.md转为output.pdf：pandoc input.md -o output.pdf。
2、在PHP中调用：exec('pandoc input.md -o output.pdf 2>&1', $outputLines, $exitCode)。
3、检查 $exitCode：值为0表示成功；非0时，$outputLines 数组包含Pandoc报错详情。
三、使用proc_open实现带超时与流控制的健壮调用
该方式可防止因Pandoc卡死导致PHP进程阻塞，并支持实时捕获错误输出与设定最大执行时间，适合生产环境部署。
1、定义描述符数组：$descriptors = [['pipe', 'r'], ['pipe', 'w'], ['pipe', 'w']]。
2、启动进程：$process = proc_open('pandoc -f markdown -t pdf', $descriptors, $pipes)。
3、向 $pipes[0] 写入原始Markdown内容，关闭该管道后调用 stream_get_contents($pipes[1]) 读取PDF二进制数据。
4、使用 proc_get_status($process)['running'] 配合循环检测超时，超时则调用 proc_terminate($process) 强制终止。
四、通过临时文件配合shell_exec规避引号与空格问题
当输入内容含特殊字符、换行或路径含空格时，直接拼接命令易引发解析错误；使用临时文件可完全绕过shell转义风险。
1、生成唯一临时输入文件：$inputFile = tempnam(sys_get_temp_dir(), 'pandoc_in_') . '.md'。
2、写入内容：file_put_contents($inputFile, $markdownContent)。
3、构造输出路径并执行：$outputFile = tempnam(sys_get_temp_dir(), 'pandoc_out_') . '.pdf'; shell_exec("pandoc '$inputFile' -o '$outputFile' 2>/dev/null")。
4、读取并清理：$pdfData = file_get_contents($outputFile); unlink($inputFile); unlink($outputFile)。
五、封装为可复用的转换类并注入参数白名单机制
该方案将调用逻辑抽象为类实例，强制限制Pandoc参数范围，防止命令注入漏洞，适用于多格式、多模板场景。
1、定义允许的输出格式白名单：$allowedFormats = ['pdf', 'docx', 'epub', 'html']。
2、校验传入格式：if (!in_array($targetFormat, $allowedFormats)) { throw new InvalidArgumentException('Unsupported format'); }。
3、构建安全参数数组：$args = ['-f', 'markdown', '-t', $targetFormat, '--standalone']，再使用 escapeshellarg() 分别处理每个参数及文件路径。
4、组合命令：$cmd = 'pandoc ' . implode(' ', array_map('escapeshellarg', $args)) . " -o " . escapeshellarg($outputPath)。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
