如何从IOFactory中获取PHPWord的sections实现HTML导出页眉页脚？

原因说明 #

PHPWord 自带的 HTML 写入器默认仅渲染正文元素，不会主动处理 sections 下的页眉、页脚属性，你可以手动提取页眉页脚内容后拼接至最终的 HTML 中，具体实现方案如下：

实现步骤 #

• 加载 docx 文件，获取 PhpWord 实例，同时初始化 HTML 写入器
• 遍历 PhpWord 实例中的所有 section，分别提取页眉、页脚，调用 HTML 写入器的元素渲染方法生成对应的 HTML 片段
• 先获取原有正文的 HTML 内容，再把页眉、正文、页脚的片段拼接为完整的 HTML 内容，最后写入到目标文件

完整代码示例 #

// 加载docx文件
$phpWord = \PhpOffice\PhpWord\IOFactory::load($saveDocPath);
$htmlWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'HTML');

// 存储页眉、页脚HTML片段
$headerHtml = '';
$footerHtml = '';

// 遍历所有section提取页眉页脚
foreach ($phpWord->getSections() as $section) {
    // 渲染当前section的所有页眉
    foreach ($section->getHeaders() as $header) {
        $headerHtml .= $htmlWriter->writeElements($header->getElements());
    }
    // 渲染当前section的所有页脚
    foreach ($section->getFooters() as $footer) {
        $footerHtml .= $htmlWriter->writeElements($footer->getElements());
    }
}

// 获取原正文HTML内容
ob_start();
$htmlWriter->save('php://output');
$bodyHtml = ob_get_clean();

// 拼接完整HTML，可自行添加样式调整页眉页脚展示效果
$fullHtml = <<<HTML
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <style>
        /* 可选：自定义页眉页脚样式 */
        .document-header { margin-bottom: 20px; border-bottom: 1px solid #eee; }
        .document-footer { margin-top: 20px; border-top: 1px solid #eee; }
    </style>
</head>
<body>
    <div class="document-header">{$headerHtml}</div>
    <div class="document-body">{$bodyHtml}</div>
    <div class="document-footer">{$footerHtml}</div>
</body>
</html>
HTML;

// 保存最终文件
file_put_contents($savePath, $fullHtml);

注意事项 #

如果文档存在多个设置了不同页眉页脚的 section，可以根据业务需要把对应 section 的页眉页脚插入到对应正文内容的前后，无需统一拼接在文档首尾。

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