MPDF项目中的页眉页脚设置全面指南

前言

在文档处理中，页眉和页脚是专业文档排版的重要组成部分。MPDF作为一款强大的PHP PDF生成库，提供了多种灵活的方式来设置页眉页脚。本文将全面解析MPDF中页眉页脚的设置方法，帮助开发者根据实际需求选择最适合的方案。

页眉页脚类型概述

MPDF支持多种类型的页眉页脚设置方式，主要分为以下几类：

1. 运行时(RUNTIME)设置

• 在文档生成过程中动态设置
• 适用于整个文档使用相同页眉页脚的情况

2. 命名(NAMED)设置

• 预先定义并命名页眉页脚模板
• 可在文档中多次引用
• 支持灵活切换不同样式

3. HTML与非HTML设置

• 非HTML方式(已弃用)：使用简单文本字符串定义
• HTML方式：使用标准HTML代码定义，功能更强大

重要注意事项

1. CSS @page选择器警告：使用@page选择器会重写/删除未在该选择器中定义的页眉页脚

2. 版本兼容性：

   • 从MPDF v6.0开始，所有页眉页脚内部都使用HTML方式处理
   • 非HTML方式虽仍支持但已被弃用
   • 命名冲突：非HTML命名页眉页脚会覆盖同名的HTML页眉页脚

3. 绝对定位支持：

   • 从MPDF v7.1开始支持绝对定位
   • 但不能同时使用绝对定位和非绝对定位内容

详细设置方法对比

方法1：运行时非HTML设置(已弃用)

• 特点：最简单快捷，但样式控制有限
• 适用场景：整个文档使用简单页眉页脚
• 相关函数：
  • SetHeader()
  • SetFooter()
• 样式控制变量：
  • $defaultheaderfontsize
  • $defaultheaderfontstyle
  • $defaultheaderline
  • 对应的footer变量

方法2：运行时HTML设置

• 特点：支持复杂布局和图片
• 适用场景：整个文档使用复杂HTML页眉页脚
• 相关函数：
  • SetHTMLHeader()
  • SetHTMLFooter()

方法3：命名非HTML设置(已弃用)

• 特点：可定义多个模板灵活切换
• 适用场景：文档中需要变化简单页眉页脚
• 相关函数/标签：
  • DefHeaderByName()
  • DefFooterByName()
  • <pageheader>
  • <pagefooter>

方法4：命名HTML设置

• 特点：结合HTML的强大功能和命名模板的灵活性
• 适用场景：文档中需要变化复杂HTML页眉页脚
• 相关函数/标签：
  • DefHTMLHeaderByName()
  • DefHTMLFooterByName()
  • <htmlpageheader>
  • <htmlpagefooter>

引用命名页眉页脚的方法

1. 文档开始时设置：

   • 非HTML：SetHeaderByName(), SetFooterByName()
   • HTML：SetHTMLHeaderByName(), SetHTMLFooterByName()
   • 对应HTML标签

2. 文档中间变更：

   • 通过分页函数指定：
     • AddPage()
     • TOCpagebreak()
     • 对应HTML分页标签
   • 可引用任何已命名的页眉页脚(HTML或非HTML)

实用技巧

1. 动态内容插入：

   • 使用{PAGENO}插入页码
   • 使用{DATE j-m-Y}插入日期(格式可自定义)

2. 性能考虑：

   • HTML页眉页脚处理更耗资源
   • 对长文档或复杂文档，简单非HTML方式可能更高效

3. 特殊变量：

   • forcePortraitHeaders：控制横向页面页眉显示方式

最佳实践建议

1. 新项目建议使用HTML方式，功能更强大且是未来方向
2. 简单文档可使用运行时设置，复杂文档推荐使用命名模板
3. 注意样式继承和覆盖规则，避免意外冲突
4. 长文档应注意内存使用，合理选择设置方式

通过理解这些设置方法的区别和适用场景，开发者可以更高效地利用MPDF生成专业级的PDF文档。