Laravel使用barryvdh/laravel-dompdf生成多页PDF异常求助

嘿，我之前用dompdf生成多页PDF的时候也踩过类似的坑，咱们来一步步排查并解决你的问题：

问题根源分析 #

先拆解你目前的两种尝试的问题：

1. 控制器循环拼接视图HTML：每个循环都渲染了完整的<html>+<head>+<body>结构，拼接后整个HTML文档变成了多个独立文档嵌套的非法结构，dompdf解析时只能识别第一个完整文档，所以只显示第一页或者直接异常。
2. Blade视图内循环：你之前的Blade里每个条目都重复了完整的页面结构，加上@page规则重复定义，dompdf对这种重复的页面规则处理有冲突，最终只保留了最后一页的渲染结果。

正确解决方案（推荐） #

步骤1：修改控制器，一次性传递所有数据给视图 #

不需要循环拼接HTML，直接把整个数据集传给视图，让Blade来处理循环逻辑：

public function multiplePagesPdf(Request $request) { 
    $kuponai = Kuponas::all(); 
    // 直接加载视图并传递所有数据
    $pdf = PDF::loadView('pdf.multiple', compact('kuponai')); 
    $pdf->setPaper('a4', 'landscape'); 
    return $pdf->stream('sugeneruoti.pdf'); 
}

步骤2：重构Blade视图，统一页面结构并正确设置分页 #

去掉重复的HTML结构，全局定义一次页面样式，循环渲染每个优惠券并添加分页符：

<!DOCTYPE html> 
<html lang="en"> 
<head> 
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
    <title>Dovanų kuponas</title> 
    <style> 
        /* 全局定义页面尺寸 */
        @page { 
            size: A4 landscape; 
            margin: 0; 
        }
        /* 每个页面的容器，确保分页符生效 */
        .coupon-page {
            width: 21cm; 
            height: 16cm; 
            page-break-after: always; /* 每个页面后强制分页 */
            position: relative; 
            font-family: DejaVu Sans; 
            background: white; 
        }
        /* 最后一页不需要添加分页符（可选优化） */
        .coupon-page:last-child {
            page-break-after: avoid;
        }
        .container {
            position: absolute; 
            top: 6.8cm; 
        }
    </style>
</head> 
<body> 
    @foreach($kuponai as $kuponas)
        <div class="coupon-page">
            <div class="container"> 
                <h2>{!! $kuponas->kupono_nr !!}</h2> 
                <h3 style="margin-left: 3.2cm"> 
                    Dovanų kupono numeris: <span style="color: black">{!! $kuponas->kupono_nr !!}</span> 
                </h3> 
            </div>
        </div>
    @endforeach
</body> 
</html>

额外注意事项 #

• 字体兼容性：确保DejaVu Sans字体是dompdf支持的（dompdf默认包含这个字体，但若自定义字体需正确配置），避免字体缺失导致布局错乱。
• 分页符位置：page-break-after: always必须放在包裹整个页面内容的容器上，不要放在内部元素，否则分页可能不生效。
• 避免重复页面规则：不要在循环内重复定义@page，全局定义一次即可，dompdf会应用到所有页面。

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