Laravel 5.5+barryvdh/laravel-snappy：PDF新增无页眉页脚页面问题

我之前在项目里也碰到过一模一样的情况——用snappy（基于wkhtmltopdf）生成预算PDF，前几页需要页眉页脚，最后一页条款要干净无装饰，试了JS和CSS直接移除没效果，后来摸索出几个靠谱的方案：

方案一：分开生成PDF再合并（最稳定） #

wkhtmltopdf的页眉页脚设置是全局的，直接在同一个视图里控制容易出问题，分开生成再合并是最稳妥的方式：

1. 生成带页眉页脚的预算文档
   先正常生成前两页的预算PDF，保存到临时目录：

   // 加载预算视图，设置页眉页脚和边距
   $budgetPdf = \PDF::loadView('documents.budget', $budgetData)
       ->setOption('header-html', public_path('pdf/templates/header.html'))
       ->setOption('footer-html', public_path('pdf/templates/footer.html'))
       ->setOption('margin-top', '20mm')
       ->setOption('margin-bottom', '20mm');
   
   // 保存到临时文件
   $budgetTempPath = storage_path('temp/budget_' . time() . '.pdf');
   $budgetPdf->save($budgetTempPath);
   

2. 生成无页眉页脚的条款页
   单独生成条款页，清空页眉页脚配置，调整边距：

   $termsPdf = \PDF::loadView('documents.terms', $termsData)
       ->setOption('header-html', '') // 清空页眉模板
       ->setOption('footer-html', '') // 清空页脚模板
       ->setOption('margin-top', '10mm') // 不需要页眉，缩小上边距
       ->setOption('margin-bottom', '10mm');
   
   $termsTempPath = storage_path('temp/terms_' . time() . '.pdf');
   $termsPdf->save($termsTempPath);
   

3. 合并两个PDF文件
   用wkhtmltopdf的命令行工具合并（确保服务器上已安装wkhtmltopdf，且路径正确）：

   $mergedPath = storage_path('temp/merged_' . time() . '.pdf');
   // 调用wkhtmltopdf合并命令，注意路径要正确
   exec("wkhtmltopdf --enable-local-file-access {$budgetTempPath} {$termsTempPath} {$mergedPath}");
   
   // 输出合并后的PDF，并且发送后自动删除临时文件
   return response()->file($mergedPath)
       ->deleteFileAfterSend(true)
       ->header('Content-Type', 'application/pdf');
   
   // 别忘了手动清理剩下的临时文件，或者用定时任务定期清理storage/temp
   

方案二：用CSS @page 规则控制最后一页（适合条款单页场景） #

如果条款内容刚好一页，可以试试用CSS的@page:last规则来覆盖全局页眉页脚，不过这个方法对wkhtmltopdf版本有要求（建议用0.12.5+）：

在你的PDF视图CSS里添加：

/* 全局页面设置 */
@page {
    margin-top: 20mm;
    margin-bottom: 20mm;
    /* 绑定页眉页脚元素 */
    @top-center { content: element(header); }
    @bottom-center { content: element(footer); }
}

/* 最后一页的特殊设置 */
@page:last {
    margin-top: 10mm;
    margin-bottom: 10mm;
    /* 清空页眉页脚内容 */
    @top-center { content: none; }
    @bottom-center { content: none; }
}

/* 定义页眉页脚的运行元素 */
.pdf-header { position: running(header); }
.pdf-footer { position: running(footer); }

/* 给条款页添加强制分页，确保它成为最后一页 */
.terms-section {
    page-break-before: always;
}

然后在视图里，把条款内容放在带有terms-section类的容器里，这样条款页会自动触发@page:last的规则，去掉页眉页脚。

注意：如果条款内容超过一页，只有最后一页会生效，前面的条款页还是会带页眉页脚，所以这个方案只适合条款内容不多的场景。

一些注意事项 #

• 临时文件目录要确保web服务器用户有读写权限，避免保存失败
• 定期清理临时文件，可以用Laravel的任务调度（Schedule）来实现
• 如果用wkhtmltopdf命令合并，要确认服务器上的wkhtmltopdf路径正确，或者在snappy配置里指定binary路径

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