MPDF项目实战：使用运行时HTML方法设置页眉页脚

前言

在PDF文档生成过程中，页眉和页脚的设计是提升文档专业性的重要元素。MPDF作为一款强大的PHP PDF生成库，提供了多种设置页眉页脚的方法。本文将重点介绍其中最高效的运行时HTML方法（Method 2），这种方法既简单又灵活，特别适合需要在整个文档中使用统一页眉页脚样式的场景。

运行时HTML方法概述

运行时HTML方法（RUNTIME HTML）是MPDF中设置页眉页脚最直接的方式，具有以下特点：

1. 即时生效：在写入文档内容前设置即可应用于整个文档
2. 支持HTML：可以使用完整的HTML标签和CSS样式
3. 灵活性高：可以包含图片、表格等复杂布局
4. 性能优越：相比其他方法处理速度更快

基础设置方法

单页文档设置

对于简单的单页文档，设置方法非常直观：

$mpdf = new \Mpdf\Mpdf();

// 设置页眉
$mpdf->SetHTMLHeader('
<div style="text-align: right; font-weight: bold;">
    我的文档标题
</div>');

// 设置页脚
$mpdf->SetHTMLFooter('
<table width="100%">
    <tr>
        <td width="33%">{DATE Y-m-d}</td>
        <td width="33%" align="center">第{PAGENO}页/共{nbpg}页</td>
        <td width="33%" style="text-align: right;">公司名称</td>
    </tr>
</table>');

$mpdf->WriteHTML('文档内容...');
$mpdf->Output();

双面文档设置

对于需要区分奇偶页的双面打印文档，可以分别设置：

$mpdf = new \Mpdf\Mpdf();

// 奇数页页眉
$mpdf->SetHTMLHeader(
    '<div style="text-align: right; border-bottom: 1px solid #000;">奇数页标题</div>',
    'O'  // O表示奇数页
);

// 偶数页页眉
$mpdf->SetHTMLHeader(
    '<div style="border-bottom: 1px solid #000;">偶数页标题</div>',
    'E'  // E表示偶数页
);

// 奇数页页脚
$mpdf->SetHTMLFooter('
<div style="text-align: right; font-family: SimSun; font-size: 9pt;">
    第{PAGENO}页
</div>', 'O');

// 偶数页页脚
$mpdf->SetHTMLFooter('
<div style="font-family: SimSun; font-size: 9pt;">
    第{PAGENO}页
</div>', 'E');

$mpdf->WriteHTML('文档内容...');
$mpdf->Output();

高级应用技巧

文档中途更改页眉页脚

当需要在文档不同部分使用不同的页眉页脚时，需要注意MPDF的页面生成顺序：

1. 先输出当前页的页脚
2. 然后创建新页面
3. 最后输出新页面的页眉

因此正确的操作顺序应该是：

// 确保当前在偶数页
$mpdf->AddPage('','E');

// 先设置新页面的页眉
$mpdf->SetHTMLHeader('新章节页眉','O');
$mpdf->SetHTMLHeader('新章节页眉','E');

// 然后添加新页面
$mpdf->AddPage();

// 最后设置新页面的页脚
$mpdf->SetHTMLFooter('新章节页脚','O');
$mpdf->SetHTMLFooter('新章节页脚','E');

临时取消页眉页脚

如需在特定页面取消页眉页脚，可以传递空值：

// 确保当前在偶数页
$mpdf->AddPage('','E');

// 取消页眉
$mpdf->SetHTMLHeader('');

// 添加新页面
$mpdf->AddPage();

// 取消页脚
$mpdf->SetHTMLFooter('');

$mpdf->WriteHTML('这个页面没有页眉页脚');

特殊场景处理

目录页处理

对于包含目录(TOC)的文档，建议使用命名方法(Method 4)更为方便。如果必须使用运行时方法，需要注意：

// 设置前言部分的页眉页脚
$mpdf->SetHTMLHeader('前言','O');
$mpdf->SetHTMLHeader('前言','E');
$mpdf->SetHTMLFooter('{PAGENO}','O');
$mpdf->SetHTMLFooter('{PAGENO}','E');

// 添加前言页(不显示页码)
$mpdf->AddPage('', '', 1, '', 'on');

// 准备正文部分
$mpdf->AddPage('','E');

// 设置正文页眉
$mpdf->SetHTMLHeader('正文','O');
$mpdf->SetHTMLHeader('正文','E');

// 添加目录页(页码从1开始)
$mpdf->TOCpagebreak('', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '',
    '<h2>目录</h2>', '目录结束', '目录', 
    1, '1', 'off');

// 设置正文页脚
$mpdf->SetHTMLFooter('正文-{PAGENO}','O');
$mpdf->SetHTMLFooter('正文-{PAGENO}','E');

最佳实践建议

1. 样式统一：建议将页眉页脚的CSS样式提取为类，保持全文档一致
2. 字体选择：使用支持中文的字体如SimSun、Microsoft YaHei等
3. 性能优化：复杂的HTML页眉页脚会增加处理时间，尽量简化
4. 测试打印：双面打印前务必实际测试奇数偶页的显示效果
5. 版本兼容：不同MPDF版本对HTML的支持可能有差异，注意测试

常见问题解答

Q: 为什么我的页眉页脚在某些页面不显示？ A: 请检查是否在写入内容前设置了页眉页脚，并确保没有在后续代码中意外覆盖了设置。

Q: 如何让第一页不显示页眉页脚？ A: 可以在设置常规页眉页脚前，先添加一个没有页眉页脚的封面页。

Q: 页脚中的页码不更新怎么办？ A: 确保使用{PAGENO}和{nbpg}这样的占位符，而不是硬编码页码。

通过掌握这些运行时HTML设置页眉页脚的技巧，您可以轻松创建出专业级别的PDF文档。对于更复杂的需求，MPDF还提供了其他方法，但运行时HTML方法在大多数情况下都能提供最佳的易用性和性能平衡。