Laravel 10.48.3集成dompdf时页码总数重叠问题求助

问题根源 #

你碰到的是dompdf（Laravel里PDF::loadView默认依赖的PDF生成库）的渲染逻辑问题：fixed定位时第一页的总页码计算提前导致数值重叠，取消fixed后页眉无法跨页重复渲染。

具体修复方案 #

1. 配置正确的页眉CSS与dompdf参数 #

在你的PDF视图文件里，给页眉容器和页面边距设置如下CSS：

@page {
    margin-top: 35px; /* 预留足够的页眉空间 */
    margin-bottom: 30px;
}

.page-header {
    position: fixed;
    top: 0;
    left: 0;
    right: 0;
    height: 25px;
    text-align: center;
    font-size: 12px;
    padding-top: 5px;
}

同时在控制器加载视图时，开启dompdf的HTML5解析支持，避免页码计算错误：

$pdf = PDF::loadView('your-pdf-template', $data)
    ->setOptions([
        'isHtml5ParserEnabled' => true,
        'isPhpEnabled' => true
    ]);

2. 正确渲染内置页码变量 #

直接在fixed定位的页眉容器里使用dompdf原生的{PAGE_NUM}和{PAGE_COUNT}变量，不要手动拼接：

<div class="page-header">
    Page {PAGE_NUM} / {PAGE_COUNT}
</div>

3. 避免正文与页眉重叠 #

给正文内容设置对应上边距，防止第一页内容顶到页眉引发渲染异常：

.pdf-content {
    margin-top: 35px; /* 与@page的margin-top值保持一致 */
}

4. 强制触发页码重计算（针对顽固场景） #

如果上述方法无效，在视图末尾添加一段PHP脚本，直接调用dompdf的画布API渲染页码：

<?php
    if (isset($pdf)) {
        $pdf->getDomPDF()->getCanvas()->page_script('
            $canvas = $pdf->get_canvas();
            $canvas->page_text(
                $canvas->get_width() / 2 - 30, 
                20, 
                "Page {PAGE_NUM} / {PAGE_COUNT}", 
                null, 
                12, 
                array(0, 0, 0)
            );
        ');
    }
?>

注意要确保控制器里已经开启isPhpEnabled配置，这段脚本才能生效。

验证步骤 #

1. 执行php artisan cache:clear清除视图缓存，避免旧代码干扰
2. 重新生成PDF，检查第一页页码是否正常、第二页是否显示页码
3. 根据实际PDF内容调整margin和top值，确保页眉与正文无重叠

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