README

Fast Excel为Laravel提供快速Excel导入/导出，得益于Spout。下面是基准测试。

快速开始

通过composer安装

composer require rap2hpoutre/fast-excel

将模型导出为.xlsx文件

use Rap2hpoutre\FastExcel\FastExcel;
use App\User;

// Load users
$users = User::all();

// Export all users
(new FastExcel($users))->export('file.xlsx');

导出

导出模型或一个集合

$list = collect([
    [ 'id' => 1, 'name' => 'Jane' ],
    [ 'id' => 2, 'name' => 'John' ],
]);

(new FastExcel($list))->export('file.xlsx');

导出xlsx、ods和csv

$invoices = App\Invoice::orderBy('created_at', 'DESC')->get();
(new FastExcel($invoices))->export('invoices.csv');

指定列名仅导出一些属性

(new FastExcel(User::all()))->export('users.csv', function ($user) {
    return [
        'Email' => $user->email,
        'First Name' => $user->firstname,
        'Last Name' => strtoupper($user->lastname),
    ];
});

下载（从控制器方法中）

return (new FastExcel(User::all()))->download('file.xlsx');

导入

import返回一个集合

$collection = (new FastExcel)->import('file.xlsx');

使用特定的分隔符、封装字符和“gbk”编码导入csv

$collection = (new FastExcel)->configureCsv(';', '#', 'gbk')->import('file.csv');

导入并插入到数据库

$users = (new FastExcel)->import('file.xlsx', function ($line) {
    return User::create([
        'name' => $line['Name'],
        'email' => $line['Email']
    ]);
});

门面

您可以使用可选的门面来使用FastExcel。将以下行添加到config/app.php中的aliases键下。

'FastExcel' => Rap2hpoutre\FastExcel\Facades\FastExcel::class,

使用门面，您将无法访问构造函数。您可以使用data方法设置您的导出数据。

$list = collect([
    [ 'id' => 1, 'name' => 'Jane' ],
    [ 'id' => 2, 'name' => 'John' ],
]);

FastExcel::data($list)->export('file.xlsx');

全局助手

FastExcel提供了一个方便的全局助手，可以在Laravel应用程序的任何地方快速实例化FastExcel类。

$collection = fastexcel()->import('file.xlsx');
fastexcel($collection)->export('file.xlsx');

高级用法

导出多个工作表

通过创建一个SheetCollection来导出多个工作表

$sheets = new SheetCollection([
    User::all(),
    Project::all()
]);
(new FastExcel($sheets))->export('file.xlsx');

使用索引指定工作表名称

$sheets = new SheetCollection([
    'Users' => User::all(),
    'Second sheet' => Project::all()
]);

导入多个工作表

使用importSheets导入多个工作表

$sheets = (new FastExcel)->importSheets('file.xlsx');

您也可以通过其编号导入特定的工作表

$users = (new FastExcel)->sheet(3)->import('file.xlsx');

通过工作表名称导入多个工作表

$sheets = (new FastExcel)->withSheetsNames()->importSheets('file.xlsx');

使用分块导出大型集合

逐行导出以避免memory_limit问题 使用yield

function usersGenerator() {
    foreach (User::cursor() as $user) {
        yield $user;
    }
}

// Export consumes only a few MB, even with 10M+ rows.
(new FastExcel(usersGenerator()))->export('test.xlsx');

添加标题和行样式

使用headerStyle和rowsStyle方法添加标题和行样式。

$header_style = (new StyleBuilder())->setFontBold()->build();

$rows_style = (new StyleBuilder())
    ->setFontSize(15)
    ->setShouldWrapText()
    ->setBackgroundColor("EDEDED")
    ->build();

return (new FastExcel($list))
    ->headerStyle($header_style)
    ->rowsStyle($rows_style)
    ->download('file.xlsx');

为什么？

FastExcel旨在成为Laravel风格的Spout：一个简单但优雅的包装器，其目标是简化导入和导出。它可以被认为是Laravel Excel的更快（且内存友好）的替代品，功能较少。仅用于简单任务。

基准测试

在2015年2.7 GHz Intel Core i5 MacBook Pro 16 Go 1867 MHz DDR3上测试。测试了10000行、20列的随机数据的XLSX导出，10次迭代，2018-04-05。 不要相信基准测试。

尽管如此，请记住Laravel Excel 有许多更多功能。