如何用PHP脚本生成带非可打印背景的PDF？

我完全懂你这种挫败感——明明在Adobe Acrobat里点几下就能搞定的设置，用开源PHP PDF库实现起来却处处卡壳。你提到的TCPDF/FPDF/mPDF的Image方法本质是把图片当成文档内容的一部分，自然会被打印；而HTML转PDF的方案确实不靠谱，因为这类库大多不会严格解析media="print"的样式，毕竟PDF和HTML的渲染模型完全不同。

下面是几个实际可行的方案，也是很多企业处理这类需求的常用思路：

1. 使用商业PDF库：PDFlib #

PDFlib是专业级的PDF处理库（有免费非商业版和商业版），它原生支持设置对象的打印可见性，完美匹配你的需求。示例代码大概是这样的：

<?php
$pdf = new PDFlib();
if ($pdf->begin_document("", "") == 0) {
    die("初始化PDF失败: " . $pdf->get_errmsg());
}

$pdf->set_info("Creator", "PHP PDF Script");
$pdf->set_info("Title", "背景仅查看可见");

// 加载背景图片
$bgImg = $pdf->load_image("auto", "your-background.jpg", "");
if ($bgImg == 0) {
    die("加载背景图失败: " . $pdf->get_errmsg());
}

$pdf->begin_page_ext(595, 842, ""); // A4尺寸

// 关键：添加背景时指定`print=false`参数
$pdf->fit_image($bgImg, 0, 0, "boxsize={595 842} position=center print=false");

// 添加正文内容（这部分会正常打印）
$pdf->setfont("Helvetica", "", 14);
$pdf->show_xy("这段文字会被打印，背景不会", 50, 750);

$pdf->end_page_ext("");
$pdf->close_image($bgImg);
$pdf->end_document("");

// 输出PDF
header("Content-type: application/pdf");
echo $pdf->get_buffer();
?>

它直接在添加背景时控制打印属性，不需要后期处理，是最省心的方案。

2. 用Ghostscript后期修改PDF #

如果不想用商业库，可以先通过TCPDF/FPDF生成带背景的PDF，再用Ghostscript（一款强大的开源PDF处理工具）修改背景对象的打印属性。

首先生成带背景的基础PDF，然后执行以下命令（PHP里可以用exec()或者shell_exec()调用）：

gs -o final-no-print-bg.pdf -sDEVICE=pdfwrite -dNOSAFER \
-c "/NoPrint << /Print false /View true >> def" \
-c "mark {/NoPrint pdfmark}" \
-f your-generated-pdf.pdf

这个命令会给PDF添加一个pdfmark，标记背景层为仅查看可见。如果你的背景是单独的图层，效果会更精准；如果是嵌入的图片，可能需要调整命令来定位目标对象，但大多数场景下这个方法能生效。

3. 结合FPDI和TCPDF/FPDF做底层修改 #

FPDI可以导入和修改现有PDF的底层对象，你可以先用TCPDF生成带背景的PDF，再用FPDI加载它，然后修改背景图片的Print属性：

<?php
require_once('tcpdf.php');
require_once('fpdi.php');

class CustomPDF extends FPDI {
    function addNonPrintableBackground($bgPath) {
        // 添加背景图片
        $imgId = $this->Image($bgPath, 0, 0, 210, 297, '', '', '', false, 300, '', false, false, 0);
        
        // 获取当前页面的资源对象
        $pageResources = $this->getPageObj()->getResources();
        // 找到背景图片的XObject
        foreach ($pageResources->getAll()['XObject'] as $obj) {
            if ($obj->getType() === 'XObject' && $obj->getSubtype() === 'Image') {
                // 设置Print属性为false
                $obj->dict->addKey('Print', new \setasign\Fpdi\PdfParser\Type\PdfBoolean(false));
                break;
            }
        }
    }
}

$pdf = new CustomPDF();
$pdf->AddPage();
$pdf->addNonPrintableBackground('your-background.jpg');

// 添加正文
$pdf->SetFont('Arial', '', 12);
$pdf->Cell(0, 10, "这段内容会正常打印", 0, 1);

$pdf->Output('final.pdf', 'I');
?>

这个方案需要对PDF的底层结构有一点了解，但好处是基于开源库实现，不需要额外商业授权。

关于大企业的处理方式 #

其实大部分企业遇到这类精细PDF控制需求时，不会局限于纯PHP开源库：

• 要么采购商业PDF服务，直接调用接口完成背景设置；
• 要么搭建内部工具链，用Ghostscript、Imagemagick等命令行工具配合PHP调用，完成PDF的后期处理；
• 对于高频需求，甚至会自己封装基于PDFlib或其他专业库的内部SDK。

毕竟开源PHP PDF库的定位是快速生成基础PDF，在这类高级属性控制上确实有局限性。

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