当前位置: 首页 > 新闻动态 > 技术教程

Laravel如何生成PDF或Excel文件_Laravel文档导出工具与使用教程

作者:下次还敢 浏览: 发布日期:2025-12-01
[导读]:Laravel通过集成第三方库实现PDF和Excel导出:使用barryvdh/laravel-dompdf生成PDF,需创建Blade模板并支持内联样式;导出Excel则用maatwebsite/excel,通过创建导出类实现FromCollection或FromQuery接口,支持自定义表头、样式等;建议大数据量时用FromQuery分块查询,PDF注意中文字体嵌入,Excel适用于复杂结构,可结合队列异步处理提升性能。
Laravel通过集成第三方库实现PDF和Excel导出:使用barryvdh/laravel-dompdf生成PDF,需创建Blade模板并支持内联样式;导出Excel则用maatwebsite/excel,通过创建导出类实现FromCollection或FromQuery接口,支持自定义表头、样式等;建议大数据量时用FromQuery分块查询,PDF注意中文字体嵌入,Excel适用于复杂结构,可结合队列异步处理提升性能。

Laravel 本身不直接生成 PDF 或 Excel 文件,但通过集成第三方库可以轻松实现文档导出功能。常用的工具包括 barryvdh/laravel-dompdf 用于生成 PDF,以及 excel 用于导出 Excel 文件。下面介绍这两个工具的安装与使用方法。

生成 PDF:使用 laravel-dompdf

barryvdh/laravel-dompdf 是一个基于 DomPDF 的 Laravel 扩展包,能将 HTML 内容渲染为 PDF 文件。

安装步骤:
  • 运行命令安装包:composer require barryvdh/laravel-dompdf
  • Laravel 5.5+ 会自动注册服务提供者,低版本需手动添加:
    Barryvdh\DomPDF\ServiceProvider::classconfig/app.php 的 providers 数组
  • 同时添加门面:'PDF' => Barryvdh\DomPDF\Facade::class, 到 aliases 数组
基本用法:
use PDF;

public function downloadPDF()
{
    $data = ['title' => '欢迎使用 Laravel 导出 PDF'];
    $pdf = PDF::loadView('pdf.document', $data);
    return $pdf->download('document.pdf');
}

其中 pdf.document 是位于 resources/views/pdf/document.blade.php 的 Blade 模板,支持内联样式(注意不支持所有 CSS 特性)。

导出 Excel:使用 maatwebsite/excel

Maatwebsite Excel(也称 Laravel Excel)是 Laravel 中最流行的 Excel 导出/导入解决方案,支持 XLSX、CSV 等格式。

安装步骤:
  • 执行命令:composer require maatwebsite/excel
  • 发布配置文件(可选):php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"
创建导出类:
php artisan make:export UsersExport --model=User

生成的类位于 app/Exports/UsersExport.php,实现 FromCollectionFromQuery 接口:

namespace App\Exports;

use App\Models\User;
use Maatwebsite\Excel\Concerns\FromCollection;

class UsersExport implements FromCollection
{
    public function collection()
    {
        return User::all();
    }
}
在控制器中调用:
use App\Exports\UsersExport;
use Maatwebsite\Excel\Facades\Excel;

public function export()
{
    return Excel::download(new UsersExport, 'users.xlsx');
}

支持自定义表头、格式化单元格、设置样式等高级功能,可通过实现更多接口如 WithHeadingsShouldAutoSize 等增强导出效果。

实际应用场景建议
  • 导出报表时,避免一次性加载大量数据,使用 FromQuery 配合分块查询减少内存占用
  • PDF 导出适合打印场景,注意字体嵌入问题(中文可能需要设置字体路径)
  • Excel 更适合数据分析,支持公式、多工作表等复杂结构
  • 可结合队列异步处理大文件导出,提升响应速度
基本上就这些。根据业务需求选择合适的导出方式,配合 Blade 模板或 Eloquent 查询,能快速实现专业级文档输出功能。

免责声明:转载请注明出处:http://m.lexweb.cn/news/6545.html

扫一扫高效沟通

多一份参考总有益处

免费领取网站策划SEO优化策划方案

请填写下方表单,我们会尽快与您联系
感谢您的咨询,我们会尽快给您回复!