Laravel Excel 的五个隐藏功能

[复制链接]
1980shumei 发表于 2019-3-15 13:59:59 | 显示全部楼层 |阅读模式
来源:https://www.jianshu.com/p/f9e6fb812d3e
若内容不全,可点击上述链接查看来源网页,在网页中点击红色双层向下的箭头阅读全文


file

LaravelExcelpackage最近发布了3.0版本,它所具有的新功能,可以帮助简化高级需求,并且可用性极高。大家一起来探讨一下可能不知道的一些隐藏功能,这些功能使LaravelExcel成为Excel拓展的最佳首选。

1.从HTML或者是Blade导入数据

假设已经有一个HTML表格

file

模版代码--resources/views/customers/table.blade.php:

<tableclass="table"><thead><tr><th></th><th>Firstname</th><th>Lastname</th><th>Email</th><th>Createdat</th><th>Updatedat</th></tr></thead><tbody>@foreach($customersas$customer)<tr><td>{{$customer->id}}</td><td>{{$customer->first_name}}</td><td>{{$customer->last_name}}</td><td>{{$customer->email}}</td><td>{{$customer->created_at}}</td><td>{{$customer->updated_at}}</td></tr>@endforeach</tbody></table>

你可以使用它去重复导入这个表格到Excel

步骤1.生成一个Export类

phpartisanmake:exportCustomersFromView--model=Customer

步骤2.使用FromView进行操作

namespaceApp\Exports;useApp\Customer;useIlluminate\Contracts\View\View;useMaatwebsite\Excel\Concerns\FromView;classCustomersExportViewimplementsFromView{publicfunctionview():View{returnview('customers.table',['customers'=>Customer::orderBy('id','desc')->take(100)->get()]);}}

这里是导入的Excel文件:

file

注意:这里只能导出HTML表格,不能具有任何标签,比如html,body,div等。

2.导出到PDF,HTML,或是其他格式的文件

虽然包的名称是LaravelExcel,但是提供了多种导出格式,并且使用起来十分简单,只要在类里再添加一个参数即可:

returnExcel::download(newCustomersExport(),'customers.xlsx','Html');

比如这么做,就导出到了HTML,如下图所示:

file

没有太多的样式,下面是源代码:

file

不仅如此,它还可以导出到PDF,甚至你可以从中选择三种库,使用方法是一样的,你只要在最后一个参数指定格式就好了,下面是一些例子。文档示例:

file

注意:你必须通过composer安装指定的PDF包,比如:

composerrequiredompdf/dompdf

导出的PDF如下所示:

file3.按需格式化单元格

LaravelExcel有一个强有力的「爸爸」--PhpSpreadsheet。因此它就拥有其各种底层功能,包括各种方式的单元格格式化。

此处是一个如何在LaravelExport类中使用它的例子,例如app/Exports/CustomersExportStyling.php:

步骤1.在头部引入适当的类。

useMaatwebsite\Excel\Concerns\WithEvents;useMaatwebsite\Excel\Events\AfterSheet;

步骤2.在implements部分使用WithEvents接口。

classCustomersExportStylingimplementsFromCollection,WithEvents{//...

步骤3.用AfterSheet事件来创建registerEvents()方法。

/***@returnarray*/publicfunctionregisterEvents():array{return[AfterSheet::class=>function(AfterSheet$event){//...此处你可以任意格式化},];}

这里有个例子:

/***@returnarray*/publicfunctionregisterEvents():array{return[AfterSheet::class=>function(AfterSheet$event){//所有表头-设置字体为14$cellRange='A1:W1';$event->sheet->getDelegate()->getStyle($cellRange)->getFont()->setSize(14);//将样式数组应用于B2:G8范围单元格$styleArray=['borders'=>['outline'=>['borderStyle'=>\PhpOffice\PhpSpreadsheet\Style\Border::BORDER_THICK,'color'=>['argb'=>'FFFF0000'],]]];$event->sheet->getDelegate()->getStyle('B2:G8')->applyFromArray($styleArray);//将第一行行高设置为20$event->sheet->getDelegate()->getRowDimension(1)->setRowHeight(20);//设置A1:D4范围内文本自动换行$event->sheet->getDelegate()->getStyle('A1:D4')->getAlignment()->setWrapText(true);},];}

这些「随机」样例展示的结果如下所示:

file

你可以在RecipespageofPhpSpreadsheetdocs中找到所有的以上以及更多示例。

4.隐藏模型属性

假设我们已经创建了Laravel5.7默认的users表:

file

现在我们尝试用简单的FromCollection来导出用户表数据:

classUsersExportimplementsFromCollection{publicfunctioncollection(){returnUser::all();}}

在导出的Excel里,你只能看到如下字段,但是没有password和remember_token:

file

这是因为在User模型里定义了隐藏字段的属性:

classUserextendsAuthenticatable{//.../***这个数组用来定义需要隐藏的字段。**@vararray*/protected$hidden=['password','remember_token',];}

所以,默认情况下这些字段是隐藏的,如果你想在导出数据的时候某些字段不被导出的话,可以直接在模型中定义隐藏属性$hidden。

5.公式

出于某种原因,LaravelExcel包的官方文档中并没有提及公式,但是这是Excel重要的功能!

幸运的是,我们可以直接将公式写在导出数据的类中,我们需要设置cell的值,就像这样:=A2+1orSUM(A1:A10)。

其中一种方式就是实现WithMapping接口:

useApp\Customer;useMaatwebsite\Excel\Concerns\FromCollection;useMaatwebsite\Excel\Concerns\WithMapping;classCustomersExportFormulasimplementsFromCollection,WithMapping{publicfunctioncollection(){returnCustomer::all();}/***@varCustomer$customer*@returnarray*/publicfunctionmap($customer):array{return[$customer->id,'=A2+1',$customer->first_name,$customer->last_name,$customer->email,];}}

以上就是LaravelExcel的五个鲜为人知的功能。

文章转自:https://learnku.com/laravel/t/24161更多文章:https://learnku.com/laravel/c/translations