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::class到config/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,实现 FromCollection 或 FromQuery 接口:
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');
}
支持自定义表头、格式化单元格、设置样式等高级功能,可通过实现更多接口如 WithHeadings、ShouldAutoSize 等增强导出效果。
实际应用场景建议
- 导出报表时,避免一次性加载大量数据,使用
FromQuery 配合分块查询减少内存占用
- PDF 导出适合打印场景,注意字体嵌入问题(中文可能需要设置字体路径)
- Excel 更适合数据分析,支持公式、多工作表等复杂结构
- 可结合队列异步处理大文件导出,提升响应速度
基本上就这些。根据业务需求选择合适的导出方式,配合 Blade 模板或 Eloquent 查询,能快速实现专业级文档输出功能。
FromQuery 配合分块查询减少内存占用










