首页 > php框架 > Laravel > 正文

Laravel怎么集成和使用Laravel Excel导入导出表格

穿越時空
发布: 2025-11-11 22:27:02
原创
476人浏览过
答案:Laravel Excel基于PhpSpreadsheet,通过安装maatwebsite/excel包并创建导入导出类,结合控制器和路由实现Excel文件处理。1. 使用artisan命令生成UserImport和UserExport类;2. 实现ToModel、WithHeadingRow、FromCollection等接口处理数据映射与表头;3. 在控制器中调用Excel::import和Excel::download方法;4. 配置路由和前端表单完成导入导出功能;5. 可扩展数据验证、批量插入、样式设置等高级功能。注意文件类型验证和字段映射细节。

laravel怎么集成和使用laravel excel导入导出表格

在 Laravel 项目中,使用 Laravel Excel 是处理 Excel 文件导入导出最常用的方式。它基于 PhpSpreadsheet,提供了简洁的 API 来读取和写入 Excel/CSV 文件。以下是集成和使用 Laravel Excel 的完整流程。

安装 Laravel Excel

在 Laravel 项目根目录下运行以下命令来安装 maatwebsite/excel 包:

composer require maatwebsite/excel
登录后复制

安装完成后,Laravel 8+ 会自动注册服务提供者和门面,无需手动操作。如果你使用的是较早版本,需在 config/app.php 中添加:

  • 'providers' => [ Maatwebsite\Excel\ExcelServiceProvider::class, ]
  • 'aliases' => [ 'Excel' => Maatwebsite\Excel\Facades\Excel::class, ]

创建导入功能

假设我们要从 Excel 文件导入用户数据到数据库。

1. 创建一个导入类:

php artisan make:import UserImport --model=User
登录后复制

这会在 app/Imports 目录下生成 UserImport.php 文件。

2. 编辑该文件,定义如何处理每一行数据:

<?php

namespace App\Imports;

use App\Models\User;
use Illuminate\Support\Collection;
use Maatwebsite\Excel\Concerns\ToModel;
use Maatwebsite\Excel\Concerns\WithHeadingRow;

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 App\Http\Controllers;

use App\Imports\UserImport;
use Illuminate\Http\Request;
use Maatwebsite\Excel\Facades\Excel;

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 文件。

酷表ChatExcel
酷表ChatExcel

北大团队开发的通过聊天来操作Excel表格的AI工具

酷表ChatExcel 48
查看详情 酷表ChatExcel

1. 创建导出类:

php artisan make:export UserExport --model=User
登录后复制

生成 app/Exports/UserExport.php 文件。

2. 实现导出逻辑:

<?php

namespace App\Exports;

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

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 功能。不复杂但容易忽略细节,比如文件类型验证、字段映射、表头处理等,注意测试边界情况。

以上就是Laravel怎么集成和使用Laravel Excel导入导出表格的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号