Laravel MPDF 加载多个 Blade 视图生成 PDF 文档

大晨君_9764

大晨君_9764

2025-11-18

218人浏览

原创

laravel mpdf 加载多个 blade 视图生成 pdf 文档

本教程旨在解决在使用 Laravel MPDF 扩展包生成 PDF 文档时,如何加载多个 Blade 视图并将其合并到单个 PDF 文件中的问题。通过循环遍历视图并使用 `AddPage()` 和 `WriteHTML()` 方法,可以轻松实现多页面 PDF 文档的生成。

在使用 Laravel 开发 Web 应用时,经常需要生成 PDF 报告或文档。mccarlosen/laravel-mpdf 是一个流行的 Laravel 扩展包,它基于 mPDF 库,能够方便地生成 PDF 文件。然而,该扩展包的默认用法通常只允许从单个 Blade 视图生成 PDF。如果需要将多个 Blade 视图合并到一个 PDF 文件中(例如,每一页使用不同的视图),则需要进行一些额外的处理。

以下是如何使用 Laravel MPDF 加载多个 Blade 视图生成 PDF 文档的详细步骤和示例代码:

步骤 1:安装 Laravel MPDF 扩展包

如果尚未安装,请使用 Composer 安装 mccarlosen/laravel-mpdf 扩展包:

composer require mccarlosen/laravel-mpdf

安装完成后,需要发布配置文件 (可选):

php artisan vendor:publish --tag=laravel-mpdf

步骤 2:创建 Blade 视图文件

创建需要合并到 PDF 文档中的 Blade 视图文件。例如,创建 resources/views/pdf/page1.blade.php,resources/views/pdf/page2.blade.php 和 resources/views/pdf/page3.blade.php。

示例:resources/views/pdf/page1.blade.php



    <title>Page 1</title><h1>This is Page 1</h1>
    <p>Content for page 1.</p>

示例:resources/views/pdf/page2.blade.php



    <title>Page 2</title><h1>This is Page 2</h1>
    <p>Content for page 2.</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill13142" title="浏览器会话(免费版)"><img
														src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="浏览器会话(免费版)" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill13142" title="浏览器会话(免费版)" class="overflowclass">浏览器会话(免费版)</a>
													<p class="overflowclass">浏览器会话管理免费版,支持一次性页面抓取、基础会话列表与简易调试。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill13142" title="浏览器会话(免费版)" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>

步骤 3:编写 Controller 代码

在 Controller 中,编写生成 PDF 的逻辑。核心思路是循环遍历所有需要加载的 Blade 视图,并使用 AddPage() 方法添加新页面,然后使用 WriteHTML() 方法将视图的内容写入到 PDF 中。

<?php namespace App\Http\Controllers;

use PDF;
use Illuminate\Support\Facades\View;

class ReportController extends Controller
{
    public function generate_pdf()
    {
        // 定义模板数据
        $data = ['foo' => 'bar'];

        // 定义所有视图 (每个视图对应一页)
        $pdfPages = [
            'pdf.page1',
            'pdf.page2',
            'pdf.page3'
        ];

        $pdf = null;

        // 循环所有视图
        foreach ($pdfPages as $view) {
            // 如果 PDF 实例尚未定义,则创建第一个页面
            if (is_null($pdf)) {
                $pdf = PDF::loadView($view, $data);
                continue;
            }

            // 添加新页面,并将视图的 HTML 内容写入到该页面
            $pdf->getMpdf()->AddPage();
            $pdf->getMpdf()->WriteHTML((string)View::make($view, $data));
        }

        return $pdf->stream('document.pdf');
    }
}

代码解释:

  1. $data = ['foo' => 'bar'];: 定义传递给 Blade 视图的数据。
  2. $pdfPages = ['pdf.page1', 'pdf.page2', 'pdf.page3'];: 定义一个数组,其中包含所有需要加载的 Blade 视图的文件名。
  3. $pdf = null;: 初始化 PDF 实例为 null。
  4. foreach ($pdfPages as $view): 循环遍历 $pdfPages 数组,处理每个视图。
  5. if (is_null($pdf)): 检查 PDF 实例是否已经创建。如果尚未创建,则使用 PDF::loadView() 方法加载第一个视图,并将其作为 PDF 的第一页。
  6. $pdf->getMpdf()->AddPage();: 对于后续的视图,首先使用 AddPage() 方法在 PDF 文档中添加一个新页面。
  7. $pdf->getMpdf()->WriteHTML((string)View::make($view, $data));: 使用 WriteHTML() 方法将视图的内容写入到新添加的页面。这里需要注意的是,View::make($view, $data) 方法用于渲染 Blade 视图,并将其转换为 HTML 字符串。
  8. return $pdf->stream('document.pdf');: 最后,使用 stream() 方法将生成的 PDF 文档发送到浏览器。

步骤 4:配置路由

在 routes/web.php 文件中定义路由,以便访问生成 PDF 的 Controller 方法:

Route::get('/generate-pdf', 'App\Http\Controllers\ReportController@generate_pdf');

步骤 5:测试

访问 /generate-pdf 路由,即可生成包含多个 Blade 视图的 PDF 文档。

注意事项:

  • 确保 Blade 视图文件存在,并且路径正确。
  • WriteHTML() 方法需要接收 HTML 字符串作为参数,因此需要使用 View::make() 方法将 Blade 视图渲染为 HTML。
  • 根据实际需求,可以调整 Blade 视图的内容和样式。
  • 如果 PDF 文档中需要包含图片或其他资源,请确保资源路径正确。

总结:

通过循环遍历 Blade 视图,并使用 AddPage() 和 WriteHTML() 方法,可以轻松地使用 Laravel MPDF 扩展包生成包含多个页面的 PDF 文档。这种方法灵活且易于扩展,能够满足各种复杂的 PDF 生成需求。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

897

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

875

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2528

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

5161

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

7630

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

4996

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

9389

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1536

29

Laravel 框架安装指南
Laravel 框架安装指南

本指南详解 Laravel 框架安装全流程,涵盖 PHP 8.1+ 环境配置、Composer 依赖管理工具安装及国内镜像源优化。重点演示使用 composer create-project 命令创建 Laravel 10/11 项目,解决常见安装错误与依赖冲突。从环境搭建到项目初始化,助您快速完成 Laravel 开发环境部署,为后续 Web 应用开发奠定基础。适合 PHP 初学者与框架迁移开发者参考。

2026.04.09

235

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习