Laravel开发：如何使用Laravel Excel导入和导出Excel文件？

Laravel开发：如何使用Laravel Excel导入和导出Excel文件？

随着互联网的快速发展，数据的处理越来越重要，特别是在企业的数据管理中。Excel 文件已经成为企业办公的必备工具之一，因为它可以方便地存储、编辑、计算和分析数据。Laravel 是一款被广泛使用的 PHP 框架，而Laravel Excel 是为 Laravel 开发的一个 Excel 文件操作扩展包，它能够轻松地实现 Excel 文件的导入和导出。

本文将为您详细介绍 Laravel Excel 的使用方法。在本文中，我们将学习如何安装 Laravel Excel 并进行 Excel 文件的导入和导出。

一. 安装 Laravel Excel

在终端中通过 Composer 安装 Laravel Excel

composer require maatwebsite/excel

如果您使用的是 Laravel 版本小于 5.5，则需要在config/app.php文件中配置以下两个服务提供者：

MaatwebsiteExcelExcelServiceProvider::class,

'Excel' => MaatwebsiteExcelFacadesExcel::class,

如果您使用的是 Laravel 版本大于或等于 5.5，则无需手动添加服务提供者，这些服务提供者会自动添加到配置中。

在终端中通过 Artisan 命令进行发布：

php artisan vendor:publish --provider="MaatwebsiteExcelExcelServiceProvider"

这将自动生成以下配置文件和模板文件：

config/excel.php
resources/views/vendor/excel

二. 配置 Laravel Excel

配置文件 excel.php 包含了 Laravel Excel 的所有配置选项。这些选项可以直接在 .env 文件中进行定义或在config/excel.php文件中进行配置。以下是所有可能的选项的详细描述。

'default_driver' => 'local',

选项“default_driver”指定要使用的默认 driver ，这里有两种选择：local、ftp。

'cache' => [
    'enabled' => true,
    'driver' => 'laravel',
],

选项“cache”指定缓存选项，缓存可以提高速度，特别是在进行大量数据处理时。当启用缓存时，设置“cache_driver”为“laravel”或“memcached”。

'temp_path' => sys_get_temp_dir(),

选项 temp_path 指定要用于保存临时文件的文件系统路径。

'csv' => [
    'delimiter' => ',',
    'enclosure' => '"',
    'escape_character' => '\',
    'input_encoding' => 'UTF-8',
    'output_encoding' => 'UTF-8',
    'use_bom' => false,
],

选项“csv”允许配置 CSV 导入和导出的选项，主要有以下选项：

delimiter：分隔符，如：逗号，分号，Tab 等等。

enclosure：列的封闭符号。

escape_character：转义符。

input_encoding：输入编码。

output_encoding：输出编码。

use_bom：是否使用 Bom 字节序。

'exports' => [
    'force_resave' => false,
    'ignore_empty' => false,
    'pre_calculate_formulas' => false,
    'maximum_recursion' => 50,
],

选项“exports”允许配置导出选项，主要有以下选项：

force_resave：是否强制进行保存。

ignore_empty：是否忽略空单元格。

pre_calculate_formulas：是否预先计算公式。

maximum_recursion：递归的最大层数。

三. 导出 Excel 文件

Laravel Excel 对 Excel 文件的导出操作提供了很好的支持。接下来我们将演示如何使用 Laravel Excel 进行数据导出。

首先，打开控制器文件，创建一个新的 Excel 文件并导出数据：

<?php

namespace AppHttpControllers;

use MaatwebsiteExcelFacadesExcel;
use AppExportsUsersExport;

class ExportController extends Controller
{
    public function export()
    {
        return Excel::download(new UsersExport, 'users.xlsx');
    }
}

在上面的控制器方法中，我们使用Excel::download()方法创建了一个 Excel 文件。这个方法接受两个参数：

• 第一个参数 users 将是导出的数据。我们通过创建一个带有 toExcel() 方法的 UsersExport 辅助类来实现数据的导出。
• 第二个参数是文件名，它是必需的。

UsersExport 文件的内容如下所示：

<?php

namespace AppExports;

use MaatwebsiteExcelConcernsFromCollection;
use AppUser;

class UsersExport implements FromCollection
{
    public function collection()
    {
        return User::select('id', 'name', 'email')->get();
    }
}

这个类需要实现 MaatwebsiteExcelConcernsFromCollection 接口。我们可以看到 FromCollection 返回的是一个集合类，其中 get() 方法将返回该类中存储的所有用户。

这样，我们就完成了 Laravel Excel 的导出操作。

四. 导入 Excel 文件

Laravel Excel 对 Excel 文件的导入操作也提供了非常好的支持。接下来我们将演示如何使用 Laravel Excel 进行 Excel 文件的数据导入。

首先，打开控制器文件，将 Excel 文件中的数据导入数据库：

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppImportsUsersImport;

class ImportController extends Controller
{
    public function import(Request $request)
    {
        $file = $request->file('file');
        Excel::import(new UsersImport, $file);
        return redirect('/')->with('success', 'Excel 数据已成功导入！');
    }
}

在上面的控制器方法中，我们使用 Excel::import() 方法导入Excel文件。这个方法接受两个参数：

• 第一个参数是 UsersImport，它是导入 Excel 文件到数据库中的类。
• 第二个参数是要导入的 Excel 文件，它包含要导入的数据。

现在，让我们看一下 UsersImport 类：

<?php

namespace AppImports;

use MaatwebsiteExcelConcernsToModel;
use AppUser;

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

如您所见，这个类需要实现 MaatwebsiteExcelConcernsToModel 接口，这个接口定义了一个 model() 方法。该方法将被用于确定新用户的属性。

在 model() 方法中，我们使用数组的数据行信息来存储用户的属性。这里我们在Excel文件中假设第1行为用户名，第2行为电子邮箱，第3行为密码。

这就是我们使用 Laravel Excel 进行 Excel 文件的导入和导出的方式。相信您已经了解到了 Laravel Excel 的基本使用方式和一些高级特性。希望这篇文章对您的 Laravel 学习有所帮助。