Laravel项目中使用mPDF为上传PDF添加页眉的问题

问题核心在于导入的原有PDF页面会覆盖页眉区域——默认情况下mPDF的页眉是放在页面的顶部边距内的，如果原PDF的页面内容占满了整个页面（没有预留边距），导入后就会把页眉盖住；而页脚因为在底部，原页面可能没占满对应区域，所以能正常显示。

直接上修复后的代码：

// ReportController.php
// 初始化时设置顶部边距，给页眉留出空间，同时配置其他边距适配
$mpdf = new \Mpdf\Mpdf([
    'margin_top' => 20, // 顶部边距设为20mm，足够页眉显示
    'margin_bottom' => 15,
    'margin_left' => 15,
    'margin_right' => 15,
]);

$pagecount = $mpdf->SetSourceFile($request->file('document')->getPathname());

// 提前统一设置页眉页脚，无需在循环内重复调用
$mpdf->SetHTMLHeader('<div style="text-align: center; font-size: 10px;">Your header content here.</div>');
$mpdf->SetHTMLFooter('<div style="text-align: center; font-size: 10px;">Your footer content</div>');

for ($i = 1; $i <= $pagecount; $i++) {
    $mpdf->AddPage();
    $importedPage = $mpdf->ImportPage($i);
    // 获取原页面尺寸，调整模板渲染位置，避免覆盖页眉页脚
    $size = $mpdf->GetTemplateSize($importedPage);
    $mpdf->UseTemplate(
        $importedPage,
        0, // 左对齐
        $mpdf->margin_top, // 从顶部边距下方开始渲染，避开页眉区域
        $size['w'], // 保持原页面宽度
        $size['h'] - $mpdf->margin_top - $mpdf->margin_bottom // 高度减去上下边距，避开页脚
    );
}

$newPdfPath = storage_path('app/public/new_pdf_with_header_footer.pdf');
$mpdf->Output($newPdfPath, \Mpdf\Output\Destination::FILE);

关键修复细节： #

• 初始化mPDF时显式设置margin_top，为页眉预留独立显示空间。
• 调用UseTemplate时，通过调整y轴起始位置和模板高度，让导入的页面刚好填充页眉页脚之间的区域，完全避开页眉页脚的显示范围。

如果仍有异常，可以尝试：

• 给页眉HTML添加position: fixed; top: 0; width: 100%;样式，强制固定在顶部（优先用上面的边距调整方法，避免层叠冲突）。
• 检查原PDF的页面尺寸，确保和mPDF初始化时的页面尺寸一致，防止缩放导致的区域覆盖。

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