用laravel Maatwebsite\Excel 教你導出漂亮的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方法里面返回的數組就是個多表單。
接下來就是單個表單的事,都和上面的一樣。