如何使用mPDF库在Laravel 8中生成无分页的单页全页PDF

解决Laravel 8 + mPDF生成PDF强制单页展示的方案 #

默认A4为固定尺寸页面，内容超出页面高度就会触发自动分页，你可以按以下步骤调整实现单页完整展示：

1. 调整mPDF初始化配置

核心是关闭自动分页，可根据你的业务场景选择以下两种配置方案：

方案一：固定超大页面高度（简单快捷，适合内容高度波动不大的场景）

直接修改你的初始化代码即可：

$pdf = PDF::loadView('vcard.card-pdf', compact(
    'card_details', 
    'plan_details', 
    'business_card_details', 
    'feature_details', 
    'service_details', 
    'galleries_details', 
    'payment_details', 
    'business_hours', 
    'settings', 
    'shareComponent', 
    'shareContent', 
    'config', 
    'enquiry_button'
), [], [
    'format' => [210, 1600], // 单位为毫米，210为A4宽度，1600为自定义高度，可根据实际内容长度调整大小
    'autoPageBreak' => false, // 关闭自动分页机制
    'margin_left' => 5,
    'margin_right' => 5,
    'margin_top' => 5,
    'margin_bottom' => 5, // 调小页边距，减少不必要的空间占用
    'display_mode' => 'fullpage'
]);

方案二：动态计算内容高度匹配页面（适配内容高度波动大的场景）

如果内容长度不固定，可先计算内容高度再动态设置页面尺寸：

// 先渲染视图得到完整HTML内容
$html = view('vcard.card-pdf', compact(
    'card_details', 
    'plan_details', 
    'business_card_details', 
    'feature_details', 
    'service_details', 
    'galleries_details', 
    'payment_details', 
    'business_hours', 
    'settings', 
    'shareComponent', 
    'shareContent', 
    'config', 
    'enquiry_button'
))->render();

// 初始化mPDF实例
$mpdf = new \Mpdf\Mpdf([
    'autoPageBreak' => false,
    'margin_left' => 5,
    'margin_right' => 5,
    'margin_top' => 5,
    'margin_bottom' => 5,
]);

// 按A4宽度计算内容实际高度
$contentHeight = $mpdf->GetStringHeight($html, 200);
// 动态设置页面尺寸，多加10mm作为冗余空间
$mpdf->AddPageByArray([
    'width' => 210,
    'height' => $contentHeight + 10,
]);

// 写入内容并输出PDF
$mpdf->WriteHTML($html);
return $mpdf->Output('card.pdf', 'I');

2. 配合Blade模板CSS调整

在vcard.card-pdf模板的头部加入以下CSS规则，避免元素主动触发分页：

<style>
* {
    page-break-inside: avoid !important;
    page-break-after: avoid !important;
    page-break-before: avoid !important;
}
html, body {
    margin: 0;
    padding: 0;
}
</style>

效果参考：

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