信息发布→ 登录 注册 退出

Laravel怎么导出Excel文件_Laravel Excel插件使用教程

发布时间:2025-12-04

点击量:
最常用工具是Maatwebsite/Laravel-Excel;基于PhpSpreadsheet,支持导入导出Excel/CSV;安装命令为composer require maatwebsite/excel;Laravel 8+自动注册服务提供者和门面;旧版本需手动在config/app.php中添加ServiceProvider和Facade;通过php artisan make:export UsersExport --model=User生成导出类;导出类位于app/Exports目录。

在 Laravel 项目中导出 Excel 文件,最常用且功能强大的工具是 Maatwebsite/Laravel-Excel 插件。它是基于 PHPOffice 的 PhpSpreadsheet 开发的,支持导入、导出 Excel 和 CSV 文件,使用简单,扩展性强。

安装 Laravel Excel 插件

在 Laravel 项目根目录下运行以下命令安装:

composer require maatwebsite/excel

如果你使用的是 Laravel 8+ 且版本为 Laravel Excel 3.1+,无需手动注册服务提供者和门面,因为 Composer 安装后会自动发现(Auto-discovery)。

如果是旧版本,需手动添加:

  • config/app.php 中添加服务提供者:
'providers' => [
    Maatwebsite\Excel\ExcelServiceProvider::class,
]
  • 添加门面:
'aliases' => [
    'Excel' => Maatwebsite\Excel\Facades\Excel::class,
]

创建导出类

使用 Artisan 命令生成一个导出类:

php artisan make:export UsersExport --model=User

该命令会在 app/Exports 目录下生成 UsersExport.php 文件。如果没有此目录,请先创建。

编辑导出类,实现数据导出逻辑:

get();
    }

    public function headings(): array
    {
        return [
            'ID',
            '姓名',
            '邮箱',
            '注册时间'
        ];
    }
}

说明:

  • FromCollection:表示从 Eloquent 集合导出数据。
  • WithHeadings:添加表头。

在控制器中调用导出

创建一个控制器方法来触发导出:



然后在路由中注册:

Route::get('/export-users', [UserController::class, 'export']);

访问 /export-users 即可下载 users.xlsx 文件。

支持格式与自定义文件名

默认导出为 .xlsx 格式,也支持其他格式:

  • Excel::download($export, 'file.csv') → CSV
  • Excel::download($export, 'file.xls') → XLS
  • Excel::download($export, 'file.xslx', \Maatwebsite\Excel\Excel::XLSX) → 显式指定格式

高级功能(可选)

你还可以实现更多接口来自定义导出行为:

  • ShouldAutoSize:自动调整列宽。
  • WithMapping:对每行数据进行映射处理。
  • WithEvents:监听导出事件,如设置标题样式等。

例如添加自动列宽:

class UsersExport implements FromCollection, WithHeadings, ShouldAutoSize
{
    // ...
}

基本上就这些。Laravel Excel 插件让导出 Excel 变得非常简单,配合 Eloquent 模型能快速实现数据导出功能。按照上述步骤操作,你就能在项目中轻松实现导出功能了。

标签:# 接口  # 能在  # 它是  # 你还  # 会在  # 你就  # 注册时间  # 如果你  # 旧版本  # 的是  # 最常用  # 事件  # php  # auto  # require  # csv  # office  # 工具  # app  # cad  # composer  # laravel  # excel  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!