答案：laravel excel基于phpSpreadsheet，通过安装maatwebsite/excel包并创建导入导出类，结合控制器和路由实现Excel文件处理。1. 使用artisan命令生成UserImport和UserExport类；2. 实现ToModel、WithHeadingRow、FromCollection等接口处理数据映射与表头；3. 在控制器中调用Excel::import和Excel::download方法；4. 配置路由和前端表单完成导入导出功能；5. 可扩展数据验证、批量插入、样式设置等高级功能。注意文件类型验证和字段映射细节。
在 Laravel 项目中，使用 Laravel Excel 是处理 Excel 文件导入导出最常用的方式。它基于 PhpSpreadsheet，提供了简洁的 API 来读取和写入 Excel/csv 文件。以下是集成和使用 Laravel Excel 的完整流程。
安装 Laravel Excel
在 Laravel 项目根目录下运行以下命令来安装 maatwebsite/excel 包：
安装完成后，Laravel 8+ 会自动注册服务提供者和门面，无需手动操作。如果你使用的是较早版本，需在 config/app.php 中添加：
'providers' => [ MaatwebsiteExcelExcelServiceProvider::class, ]'aliases' => [ 'Excel' => MaatwebsiteExcelFacadesExcel::class, ]
创建导入功能
1. 创建一个导入类：
php artisan make:import UserImport --model=User
这会在 app/Imports 目录下生成 UserImport.php 文件。
2. 编辑该文件，定义如何处理每一行数据：
<?php namespace AppImports; use AppModelsUser; use IlluminateSupportCollection; use MaatwebsiteExcelConcernsToModel; use MaatwebsiteExcelConcernsWithHeadingRow; class UserImport implements ToModel, WithHeadingRow { public function model(array $row) { return new User([ 'name' => $row['name'], 'email' => $row['email'], 'password' => bcrypt($row['password']), ]); } }
说明：
-
ToModel表示将每行数据映射为 Eloquent 模型并保存。 -
WithHeadingRow表示跳过表头行，从第二行开始读取。
3. 在控制器中调用导入：
<?php namespace AppHttpControllers; use AppImportsUserImport; use IlluminateHttpRequest; use MaatwebsiteExcelFacadesExcel; class UserController extends Controller { public function import(Request $request) { $request->validate([ 'file' => 'required|mimes:xlsx,xls,csv' ]); Excel::import(new UserImport, $request->file('file')); return redirect()->back()->with('success', '数据导入成功！'); } }
4. 添加路由：
Route::post('/users/import', [UserController::class, 'import']);
5. 前端表单示例：
<form action="/users/import" method="POST" enctype="multipart/form-data"> @csrf <input type="file" name="file" required> <button type="submit">导入</button> </form>
创建导出功能
将数据库中的用户数据导出为 Excel 文件。
1. 创建导出类：
php artisan make:export UserExport --model=User
生成 app/Exports/UserExport.php 文件。
2. 实现导出逻辑：
<?php namespace AppExports; use AppModelsUser; use MaatwebsiteExcelConcernsFromCollection; use MaatwebsiteExcelConcernsWithHeadings; class UserExport implements FromCollection, WithHeadings { public function collection() { return User::select('id', 'name', 'email', 'created_at')->get(); } public function headings(): array { return ['ID', '姓名', '邮箱', '创建时间']; } }
说明：
-
FromCollection表示从集合导出数据。 -
WithHeadings可自定义表头名称。
3. 控制器中添加导出方法：
public function export() { return Excel::download(new UserExport, 'users.xlsx'); }
4. 添加路由：
Route::get('/users/export', [UserController::class, 'export'])->name('users.export');
5. 前端链接：
<a href="{{ route('users.export') }}">导出用户列表</a>
高级用法提示
Laravel Excel 支持更多功能，例如：
- 数据验证：实现
WithValidation接口校验导入数据。 - 批量插入：使用
WithBatchInserts(1000)提升性能。 - 自定义样式：通过
WithStyles设置单元格格式。 - 多工作表导出：使用
WithMultipleSheets。
具体可参考官方文档：https://www.php.cn/link/960a11a4601a7c97b0c171654688d787
基本上就这些。只要按步骤配置好导入导出类，再结合路由和控制器调用，就能快速实现 Excel 功能。不复杂但容易忽略细节，比如文件类型验证、字段映射、表头处理等，注意测试边界情况。