使用PHP Laravel填充PDF表单失败 求问题排查及替代解决方案

现有php-pdftk无错误返回失败的排查步骤 #

• 验证pdftk服务端安装有效性：在服务器命令行执行pdftk --version，确认能正常输出版本信息。若执行失败需重新安装pdftk，Ubuntu 20.04场景下推荐使用snap安装版本，稳定性更高。
• 核对执行路径配置：php-pdftk默认读取/usr/bin/pdftk路径，若你的pdftk安装在其他路径，实例化时需要手动指定，同时建议指定可写入的临时目录：

  $pdf = new Pdf([
      'pathToPdftk' => '/usr/bin/pdftk', // 替换为你的实际pdftk路径
      'tempDir' => '/tmp'
  ]);
  

• 检查目录权限：确认运行PHP的web用户（通常为www-data）对源PDF所在目录有读取权限、对目标保存目录有写入权限，同时确认test.pdf文件真实存在且未被加密。
• 核对表单字段名：执行命令pdftk test.pdf dump_data_fields输出PDF内所有表单字段，确认你使用的name_field和实际字段名完全匹配，大小写、特殊符号都不能有差异。
• 命令行先行验证：手动构造fdf表单数据文件，在命令行执行pdftk test.pdf fill_form data.fdf output filled.pdf flatten，如果命令行执行失败，说明问题出在PDF文件本身，和代码逻辑无关。

代码优化建议 #

添加异常捕获逻辑避免错误被静默吞噬，参考代码如下：

try {
    $sourcePdf = public_path('/test.pdf');
    if (!file_exists($sourcePdf) || !is_readable($sourcePdf)) {
        throw new Exception('源PDF不存在或无读取权限');
    }
    $targetPath = public_path('/filled.pdf');
    if (!is_writable(dirname($targetPath))) {
        throw new Exception('目标保存目录无写入权限');
    }

    $pdf = new Pdf($sourcePdf);
    $result = $pdf->fillForm([
        'name_field' => 'hello',
    ])
    ->flatten()
    ->saveAs($targetPath);

    if ($result === false) {
        throw new Exception($pdf->getError() ?: 'pdftk执行未知错误');
    }

    return response()->json(['status' => 'success', 'path' => $targetPath], 200);
} catch (Exception $e) {
    return response()->json(['error' => $e->getMessage()], 400);
}

替代PDF表单填充方案 #

• TCPDF+FPDI组合：兼容性优于原生FPDF脚本，免费版本支持PDF 1.4及以下版本的表单处理，若使用更高版本PDF可先将源文件转成PDF 1.4格式后使用。
• Ghostscript命令行调用：服务端直接安装Ghostscript后，PHP通过exec函数调用命令完成表单填充，稳定性强，不需要额外安装PHP扩展。
• 直接生成填充后PDF：如果表单模板是自己可控的，可以直接使用基于Chromium的PDF生成类库，直接渲染带有填充内容的PDF，不需要额外处理现有表单，适配性更高。

内容的提问来源于stack exchange，提问作者Tharindu Prabodhana