如何在PHP的MPDF中让顶级thead在后续页面重复显示？

问题根源 #

你当前的测试代码违反HTML规范：单个<table>只能包含一个<thead>元素，多<thead>会导致MPDF解析错误（也就是你遇到的Undefined offset: 2报错）。同时，顶级表头放在单独<table>中，MPDF无法跨table重复该表头。

解决思路与实现 #

核心是用单个table承载所有内容，将顶级表头放入唯一thead，二级表头用tbody内的行模拟，配合MPDF支持的CSS属性实现跨页重复顶级表头，同时保证二级表头与对应内容不被拆分。

1. 重构HTML结构

将所有内容合并到一个table中：

• 唯一的<thead>存放需要跨页重复的顶级表头
• 每个二级表头+内容组作为独立<tbody>，二级表头用<tr><th>或<tr><td>（加样式）实现

示例代码：

<style>
    thead {
        display: table-header-group; /* 强制MPDF在每页顶部重复thead内容 */
        background: #ffcccc; /* 对应你截图的红色高亮顶级表头 */
    }
    .sub-header {
        font-weight: bold;
        background: #ccccff; /* 区分二级表头样式 */
    }
    tbody {
        page-break-inside: avoid; /* 防止二级表头和内容被拆分到两页 */
    }
    th, td {
        padding: 8px;
        border: 1px solid #000;
    }
</style>

<table>
    <!-- 顶级表头：跨页重复 -->
    <thead>
        <tr>
            <th class="header1">FIRST</th>
        </tr>
    </thead>

    <!-- 第一组：二级表头+内容 -->
    <tbody>
        <tr>
            <th class="sub-header">SECOND</th>
        </tr>
        <tr><td>DATA</td></tr>
        <tr><td>DATA</td></tr>
        <!-- 省略更多数据行 -->
        <tr><td>DATA</td></tr>
    </tbody>

    <!-- 第二组：二级表头+内容 -->
    <tbody>
        <tr>
            <th class="sub-header">THREE</th>
        </tr>
        <tr><td>DATA</td></tr>
    </tbody>

    <tfoot>
        <tr>
            <td>END</td>
        </tr>
    </tfoot>
</table>

2. MPDF配置补充

初始化MPDF时确保自动分页开启，避免内容溢出：

$mpdf = new \Mpdf\Mpdf([
    'autoPageBreak' => true,
    'marginBottom' => 15,
    'marginTop' => 15
]);
$mpdf->WriteHTML($htmlContent);
$mpdf->Output();

关键说明 #

• display: table-header-group是MPDF识别表头重复的核心属性，必须作用于<thead>
• page-break-inside: avoid保证每个二级表头和对应内容始终在同一页（或分页后紧跟内容）
• 单个table结构符合HTML规范，避免MPDF解析报错

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