按mPDF文档配置<htmlpagefooter>后PDF页脚不显示问题求助

问题场景 #

按照mPDF规范使用<htmlpagefooter>和<sethtmlpagefooter>定义PDF页脚，但生成的PDF中所有页面均未显示页脚。不过在标签内加入PHP代码会触发错误，说明mPDF已识别并解析这些标签。

使用的原始代码：

<html>
  <head>
    <style>
        .mydiv {
            color: red;
        }
    </style>
  </head>
  <htmlpagefooter name="myfooter">
      Page {PAGENO} of {nb}
  </htmlpagefooter>

  <sethtmlpagefooter name="myfooter" value="on" />
  <body>
    <div class="mydiv">
        This is my PDF file
    </div>
  </body>
</html>

解决方案 #

1. 调整控制标签的位置 #

mPDF的<htmlpagefooter>和<sethtmlpagefooter>属于文档控制标签，必须放置在<head>标签内部，而非<head>与<body>之间。移到<head>内后，mPDF才能正确读取页脚定义并应用。

2. 预留页脚显示空间 #

默认页面底部边距可能不足以容纳页脚，需通过CSS的@page规则设置足够的底部边距，确保页脚内容能显示在页面范围内。

修改后的完整代码 #

<html>
  <head>
    <style>
        .mydiv {
            color: red;
        }
        /* 为页脚预留20mm的底部边距 */
        @page {
            margin-bottom: 20mm;
        }
    </style>
    <!-- 页脚定义移至head内部 -->
    <htmlpagefooter name="myfooter">
        <div style="text-align: center; color: #333;">Page {PAGENO} of {nb}</div>
    </htmlpagefooter>
    <!-- 启用页脚 -->
    <sethtmlpagefooter name="myfooter" value="on" />
  </head>
  <body>
    <div class="mydiv">
        This is my PDF file
    </div>
    <!-- 添加分页测试多页页脚显示 -->
    <p style="page-break-after: always;"></p>
    <div>第二页内容，页脚应该正常显示</div>
  </body>
</html>

额外检查点 #

• mPDF版本兼容性：部分旧版本对控制标签的语法或位置要求不同，建议使用最新稳定版。
• 页脚样式可见性：如果页脚文字颜色与页面背景色一致，会导致视觉上“未显示”，需给页脚内容设置明确的颜色、背景等样式。

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