Laravel开发:如何使用Laravel Excel和PHPOffice读写Excel文件?

云墨同学_4255

云墨同学_4255

2023-06-13

3125人浏览

原创

随着excel文件在商业和财务领域中的广泛使用,将excel文件整合到web应用程序中已经成为开发人员所需的技能之一。由于laravel是一种流行的php框架,其生态系统中有许多包可以帮助我们读写excel文件。本文将介绍如何使用laravel excel和phpoffice库在laravel应用程序中读写excel文件。

什么是Laravel Excel?

Laravel Excel是一个为Laravel框架开发的强大Excel处理工具。该工具提供了易于使用的API,可以帮助我们轻松地导入和导出Excel文件。该工具的一个主要优点是它允许直接操作Excel文件而无需依赖于Excel软件。

安装Laravel Excel可以通过Composer完成。在终端中进入Laravel项目的目录,并运行下面的Composer命令:

composer require maatwebsite/excel

该命令将从Packagist下载最新版本的Laravel Excel并自动完成安装过程。

如何使用Laravel Excel导出Excel文件?

Laravel Excel提供了一个Excel类,它是一个代理类,通过它可以创建新的Excel文件或打开并编辑现有的Excel文件。我们可以使用该类在Laravel应用程序中导出Excel文件。

在项目中创建一个新的Excel文件,我们可以使用Laravel Excel提供的以下模板:

<?php namespace AppExports;

use MaatwebsiteExcelConcernsFromCollection;
use MaatwebsiteExcelConcernsWithHeadings;

class ExampleExport implements FromCollection, WithHeadings
{
    public function headings(): array
    {
        return [
            'ID',
            'Name',
            'Email',
            'Phone',
        ];
    }

    /**
    * @return IlluminateSupportCollection
    */
    public function collection()
    {
        return User::select('id', 'name', 'email', 'phone')->get();
    }
}

在上面的代码中,我们定义了一个名为ExampleExport的类。该类使用FromCollection和WithHeadings接口,这些接口提供了生成Excel文件所需的方法。

在headings()方法中,我们定义了Excel文件的标题,这些标题列在Excel工作表的第一行中。在collect()方法中,我们从数据库中检索用户记录并将其返还给调用该类的控制器。

要导出Excel文件,我们可以在控制器方法中实例化ExampleExport,如下所示:

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

在上面的代码中,我们使用Laravel Excel提供的download()方法从ExampleExport导出一个Excel文件。该方法需要两个参数:第一个参数是ExampleExport实例,第二个参数是Excel文件名。

在浏览器中访问导出方法的URL时,系统将会提示您下载users.xlsx文件。

如何使用Laravel Excel导入Excel文件?

读取Excel文件并将其数据导入数据库时,我们可以使用Laravel Excel提供的import()方法。该方法接受三个参数:文件对象、任务回调和工作表名称。

为了演示如何导入Excel文件,我们将创建一个名为UserImport的类,如下所示:

Excel公式工具(专业版)
Excel公式工具(专业版)

从自然语言描述生成Excel公式,诊断表格错误,支持VLOOKUP、条件求和等常用函数。

下载
<?php namespace AppImports;

use AppUser;
use MaatwebsiteExcelConcernsToModel;

class UserImport implements ToModel
{
    public function model(array $row)
    {
        return new User([
            'name' => $row[0],
            'email' => $row[1],
            'phone' => $row[2],
        ]);
    }
}

在上面的代码中,我们使用ToModel接口实现了UserImport类。ToModel接口提供了一个必需的model()方法,该方法将每一行Excel数据转换为模型对象。在上面的代码中,我们解析了Excel文件中的前三个列并将其用于创建新的用户记录。

在控制器中使用import()方法导入Excel文件,如下所示:

public function import(Request $request)
{
    $file = $request->file('file');
    Excel::import(new UserImport, $file);
    return redirect()->back()->with('success', 'Excel file imported successfully.');
}

在上面的代码中,我们获取上传的Excel文件对象并通过Laravel Excel的import()方法将其导入到UserImport类中。如果导入成功,系统将向用户发送带有“Excel文件成功导入”的成功消息的重定向响应。

如何使用PHPOffice库读写Excel文件?

PHPOffice是一个PHP库,用于读写不同类型的办公室文件,如Excel、Word和PowerPoint等。PHPOffice与Laravel Excel不同,它不是为特定的框架开发的,可以用于任何PHP应用程序中。

在安装PHPOffice之前,您需要确保已安装PHP Zip扩展和PHP XML扩展。

使用Composer安装PHPOffice的Spreadsheet库,可以使用以下命令:

composer require phpoffice/phpspreadsheet

要创建一个新的Excel文件,我们可以使用以下代码:

<?php use PhpOfficePhpSpreadsheetSpreadsheet;
use PhpOfficePhpSpreadsheetWriterXlsx;

$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('A1', 'Hello World!');
$sheet->setCellValue('B1', 'This is PHPOffice.');

$writer = new Xlsx($spreadsheet);
$writer->save('hello.xlsx');

在上面的代码中,我们首先创建一个新的电子表格,并在其第一行的前两个列中添加了“Hello World!”和“This is PHPOffice.”的单元格。然后,我们将电子表格保存到hello.xlsx文件中。

要打开和编辑现有的Excel文件,我们可以使用以下代码:

<?php use PhpOfficePhpSpreadsheetIOFactory;

$spreadsheet = IOFactory::load('hello.xlsx');
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('C1', 'This cell has been added.');

$writer = new Xlsx($spreadsheet);
$writer->save('hello.xlsx');

在上面的代码中,我们使用IOFactory类从磁盘加载现有的Excel文件。然后,我们打开了该文件的活动工作表,并向其添加了一个新的单元格。最后,我们将更新保存到原始文件中。

结论

在本文中,我们介绍了如何使用Laravel Excel和PHPOffice库在Laravel应用程序中读写Excel文件。我们学习了如何使用Laravel Excel导出和导入Excel文件,以及如何使用PHPOffice库创建、打开和编辑现有的Excel文件。这些技术应该使您能够更轻松地整合Excel文件到您的Laravel应用程序中。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

60

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

60

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

60

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

40

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

180

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

140

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

160

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 46万人学习

成为PHP架构师-自制PHP框架
成为PHP架构师-自制PHP框架

共28课时 | 3.7万人学习