MPDF项目教程：使用命名HTML页眉页脚的高级方法

童霆腾Sorrowful

于 2025-06-13 09:03:12 发布

阅读量310

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01144/article/details/148625068

MPDF项目教程：使用命名HTML页眉页脚的高级方法

mpdf.github.io mPDF documentation 项目地址: https://gitcode.com/gh_mirrors/mp/mpdf.github.io

前言

在PDF文档生成过程中，页眉和页脚的设计是提升文档专业性的重要元素。MPDF作为强大的PHP PDF生成库，提供了多种页眉页脚设置方法。本文将重点讲解第四种方法——使用命名HTML页眉页脚，这是最灵活且功能最强大的实现方式。

命名HTML页眉页脚的优势

高度灵活性：可以在文档任何位置随时切换不同的页眉页脚样式
HTML支持：可以使用完整的HTML和CSS样式设计复杂的布局
复用性：定义的页眉页脚可以在文档中多次引用
动态内容：支持页码、日期等动态变量的插入

基本使用规范

命名规则

避免使用html_开头的名称，该前缀为系统保留
名称应具有描述性，如"ChapterHeader"、"ReportFooter"等

定义方法

MPDF提供了两种定义命名HTML页眉页脚的方式：

1. PHP方法定义

$mpdf->DefHTMLHeaderByName(
    'CustomHeader',
    '<div style="text-align: center; font-size: 12pt;">文档标题</div>'
);

$mpdf->DefHTMLFooterByName(
    'CustomFooter',
    '<div style="border-top: 1px solid #ccc; padding-top: 5pt;">
        第{PAGENO}页/共{nbpg}页
    </div>'
);

2. HTML标签定义

<htmlpageheader name="SectionHeader">
    <div style="background: #f5f5f5; padding: 10pt;">
        章节标题
    </div>
</htmlpageheader>

<htmlpagefooter name="SectionFooter">
    <table width="100%">
        <tr>
            <td>版权所有 © 2023</td>
            <td align="center">第{PAGENO}页</td>
            <td align="right">{DATE Y-m-d}</td>
        </tr>
    </table>
</htmlpagefooter>

实际应用场景

场景一：文档起始页设置

$mpdf = new \Mpdf\Mpdf();

// 定义页眉页脚
$mpdf->DefHTMLHeaderByName('FirstPageHeader', '...');
$mpdf->DefHTMLFooterByName('FirstPageFooter', '...');

// 设置初始页眉页脚
$mpdf->SetHTMLHeaderByName('FirstPageHeader');
$mpdf->SetHTMLFooterByName('FirstPageFooter');

// 开始写入内容
$mpdf->WriteHTML('文档正文内容...');

场景二：文档中间切换样式

// 定义多种样式
$mpdf->DefHTMLHeaderByName('Chapter1Header', '...');
$mpdf->DefHTMLHeaderByName('Chapter2Header', '...');

// 第一章内容
$mpdf->WriteHTML('第一章内容...');

// 切换为第二章样式
$mpdf->AddPage('', '', '', '', '', '', '', '', '', '', '', 
    'html_Chapter2Header', '', 'html_Chapter2Footer', '', 1, 0, 1, 0);

$mpdf->WriteHTML('第二章内容...');

场景三：使用CSS @page规则

<style>
@page {
    odd-header-name: html_DefaultHeader;
    odd-footer-name: html_DefaultFooter;
}

@page special-page {
    odd-header-name: html_SpecialHeader;
    odd-footer-name: html_SpecialFooter;
}

.special-section {
    page: special-page;
}
</style>

<div class="special-section">
    这部分内容将使用特殊页眉页脚
</div>