laravel Maatwebsite\Excel

第一步当然是安装包咯

环境要求

PHP: ^7.0
Laravel: ^5.5

composer require maatwebsite/excel   

目前3.1 只支持 Laravel 5.5 以上,所以会自动注册

发布配置文件:

 php artisan vendor:publish

好了 就这么简单。

接下来就是使用啦。

excel 导出

代码尽量做到解耦,所以导入导出的代码不要和原来的业务耦合。我们新建一个UserExport

php artisan make:export UsersExport --model=User
 
.
├── app
│   ├── Exports
│   │   ├── UsersExport.php
│ 
└── composer.json
 

UserExport的代码

 
<?php

namespace App\Exports;

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

class UsersExport implements FromCollection
{
    public function collection()
    {
        return User::all();
    }
}
 

业务控制器中的调用

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

这样最简单的导出就好了。

接下来我们聊一聊美化的东西。

首先我们创建一个基类BaseExport,子类直接继承就可以了,从而不用重复写。

这是我的BaseExport代码

 
<?php

namespace App\Exports;

use Maatwebsite\Excel\Concerns\ShouldAutoSize;
use Maatwebsite\Excel\Concerns\WithEvents;
use Maatwebsite\Excel\Concerns\WithStrictNullComparison;
use Maatwebsite\Excel\Events\AfterSheet;

class BaseExport implements WithEvents, WithStrictNullComparison, ShouldAutoSize
{
    /**
     * 注册事件
     * @return array
     */
    public function registerEvents(): array
    {
        return [
            AfterSheet::class => function (AfterSheet $event) {
                //设置作者
                $event->writer->setCreator('寞小陌');//writer属性现在好像有点问题。。。
                //设置列宽
                $event->sheet->getDelegate()->getColumnDimension('A')->setWidth(50);
                //设置区域单元格垂直居中
                $event->sheet->getDelegate()->getStyle('A1:Z1265')->getAlignment()->setVertical('center');
                //设置区域单元格水平居中
                $event->sheet->getDelegate()->getStyle('A1:Z1265')->getAlignment()->setHorizontal('center');
                //设置区域单元格字体、颜色、背景等,其他设置请查看 applyFromArray 方法,提供了注释
                $event->sheet->getDelegate()->getStyle('A1:Z1')->applyFromArray([
                    'font' => [
                        'name' => 'Arial',
                        'bold' => true,
                        'italic' => false,
                        'strikethrough' => false,
                        'color' => [
                            'rgb' => 'FFFFFF'
                        ]
                    ],
                    'fill' => [
                        'fillType' => 'linear', //线性填充,类似渐变
                        'rotation' => 45, //渐变角度
                        'startColor' => [
                            'rgb' => '54AE54' //初始颜色
                        ],
                        //结束颜色,如果需要单一背景色,请和初始颜色保持一致
                        'endColor' => [
                            'argb' => '54AE54'
                        ]
                    ]
                ]);
          //合并单元格
          $event->sheet->getDelegate()->mergeCells('A1:B1');
} ]; } }
 

最重要的就是WithEvents接口了,但是我们先说说WithStrictNullComparison这个接口,继承了这个接口能让你丢失的0全部给你补回来哈哈哈。

ShouldAutoSize接口让你的表格大小自适应,不是特别重要,但是用了会好点。

接下来再来说说第一个接口。

里面我找到最好用的还是垂直居中和水平居中的方法了。让表单瞬间好看很多,犹豫我们继承了自适应,所以一般也用不到设置列宽啊行高这类的。

然后设置区域内单元格的字体、颜色、背景等。我喜欢把标题加个背景色,这样能让数据和标题有个明显的区分。看起来也比较舒服。

具体看代码里的备注吧,还是比较清楚的。

接下来说一声多表单导出的问题。

直接上代码

 
<?php

namespace App\Exports;

use Maatwebsite\Excel\Concerns\WithMultipleSheets;

class FlatAccountMultipleExport implements WithMultipleSheets
{
    private $user;
    private $lang;
    private $request;

    public function __construct($user, $lang, $request)
    {
        $this->user = $user;
        $this->lang = $lang;
        $this->request = $request;
    }

    public function sheets(): array
    {
        $sheets = [
            new FlatAccountExport($this->user, $this->lang, $this->request),
            new LendingSubsidiaryExport($this->user, $this->lang, $this->request)
        ];
        return  $sheets;
    }
}
 

sheets方法里面返回的数组就是个多表单。

接下来就是单个表单的事,都和上面的一样。

 

 

3.表格导入

app/Imports中创建一个导入类
你可以使用make:import命令来做这件事。

php artisan make:import UsersImport --model=User

如果执行成功,可以在app/Imports中找到该文件UsersImport.php:
当然,如果你喜欢手动创建,你可以在app/Imports中创建以下内容:

<?php

namespace App\Imports;

use App\User;
use Illuminate\Support\Facades\Hash;
use Maatwebsite\Excel\Concerns\ToModel;

class UsersImport implements ToModel
{
    /**
     * @param array $row
     *
     * @return User|null
     */
    public function model(array $row)
    {
        return new User([
           'name'     => $row[0],
           'email'    => $row[1], 
           'password' => Hash::make($row[2]),
        ]);
    }
}

我这里是UsersController控制器,你也可以创建其它控制器都可以:

use App\Imports\UsersImport;
use Maatwebsite\Excel\Facades\Excel;
use App\Http\Controllers\Controller;

class UsersController extends Controller 
{
    public function import() 
    {
        Excel::import(new UsersImport, 'users.xlsx');
        
        return redirect('/')->with('success', 'All good!');
    }
}

最后,同样添加一个可以访问导入的路由。注意:这里是导入的用户表,测试的时候要注册导入数据要符合字段类型和长度。具体的users表导入字段可以查看app\User.php

Route::get('users/import/', 'UsersController@import');

好了,现在可以愉快的开始玩耍啦。更多的玩法可以参考官方文档:



链接:https://www.jianshu.com/p/8418da9952ef
 
https://docs.laravel-excel.com/3.1/exports/

 

posted @ 2022-05-17 13:26  星云惊蛰  阅读(951)  评论(0)    收藏  举报