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

浙公网安备 33010602011771号