你知道Laravel Excel的這五個功能嗎？

#                                                                                

Laravel Excel package 最近發表了 3.0 版本，它所具有的新功能，可協助簡化進階需求，且可用性極高。大家一起來探討一些可能不知道的隱藏功能，這些功能使 Laravel Excel 成為 Excel 拓展的最佳首選。

1. 從HTML 或是Blade 匯入資料

假設已經有一個HTML 表格

模版程式碼-- resources/views/ customers/table.blade.php:

                                                                                   @foreach ($customers as $customer)                                                                     @endforeach     

	First name	Last name	Email	Created at	Updated at
{{ $customer->id }}	{{ $customer->first_name }}	{{ $customer->last_name }}	{{ $customer->email }}	{{ $customer->created_at }}	{{ $customer->updated_at }}

你可以使用它去重複導入這個表格到Excel

步驟1. 產生一個Export 類別

php artisan make:export CustomersFromView --model=Customer

步驟2. 使用FromView 進行操作

namespace App\Exports;

use App\Customer;
use Illuminate\Contracts\View\View;
use Maatwebsite\Excel\Concerns\FromView;

class CustomersExportView implements FromView
{
    public function view(): View
    {
        return view('customers.table', [
            'customers' => Customer::orderBy('id', 'desc')->take(100)->get()
        ]);
    }
}

這裡是導入的Excel 檔案：

注意：這裡只能匯出HTML 表格，不能有任何標籤，例如html，body ，p 等。

---

2. 匯出到PDF，HTML，或是其他格式的檔案

#雖然套件的名稱是Laravel Excel，但是提供了多種匯出格式，並且使用起來十分簡單，只要在類別裡再加入一個參數即可：

return Excel::download(new CustomersExport(), 'customers.xlsx', 'Html');

例如這麼做，就導出到了HTML，如下圖所示：

沒有太多的樣式，以下是原始碼：

#不僅如此，它還可以匯出到PDF，甚至你可以從中選擇三種函式庫，使用方法是一樣的，你只要在最後一個參數指定格式就好了，以下是一些例子。文件範例:

注意：你必須透過composer 安裝指定的PDF 包，例如：

composer require dompdf/dompdf

匯出的PDF 如下所示：

---

3. 按需格式化儲存格

Laravel Excel 有一個強大的「爸爸」 -- PhpSpreadsheet。因此它就擁有其各種底層功能，包括各種方式的單元格格式化。

這裡有一個如何在 Laravel Export 類別中使用它的例子，例如 app/Exports/CustomersExportStyling.php：

步驟 1. 在頭部引入適當的類別。

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

步驟 2. 在 implements 部分使用 WithEvents 介面。

class CustomersExportStyling implements FromCollection, WithEvents
{
    // ...

步驟 3. 用 AfterSheet 事件來建立 registerEvents() 方法。

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

這裡有個例子：

/**
 * @return array
 */
public function registerEvents(): 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);
        },
    ];
}

這些「隨機」範例展示的結果如下所示：

你可以在Recipes page of PhpSpreadsheet docs中找到所有的以上以及更多範例。

---

4. 隱藏模型屬性

假設我們已經建立了Laravel 5.7預設的users表:

#現在我們嘗試用簡單的FromCollection來導出用戶表資料：

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

在導出的Excel 裡，你只能看到如下字段，但是沒有password和remember_token：

#這是因為在User模型裡定義了隱藏欄位的屬性：

class User extends Authenticatable
{
    // ...

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

所以，預設情況下這些欄位是隱藏的，如果你想在匯出資料的時候某些欄位不被匯出的話，可以直接在模型中定義隱藏屬性$hidden。

---

5. 公式

出於某種原因，Laravel Excel 套件的官方文件中並沒有提及公式，但這是Excel 重要的功能！

幸運的是，我們可以直接將公式寫在導出資料的類別中，我們需要設定cell 的值，就像這樣：=A2 1 or SUM(A1 :A10)。

其中一個方法就是實作WithMapping 介面：

use App\Customer;
use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\WithMapping;

class CustomersExportFormulas implements FromCollection, WithMapping
{
    public function collection()
    {
        return Customer::all();
    }

    /**
     * @var Customer $customer
     * @return array
     */
    public function map($customer): array
    {
        return [
            $customer->id,
            '=A2+1',
            $customer->first_name,
            $customer->last_name,
            $customer->email,
        ];
    }
}

以上就是Laravel Excel的五個鮮為人知的功能。

如果你想了解更多的話，我有一套線上教學Excel Export/Import in Laravel，快去看看吧!

原文網址：https://laravel-news.com/five-hidden-features-of-the-laravel-excel-package

翻譯網址：https://learnku.com /laravel/t/24161

以上是你知道Laravel Excel的這五個功能嗎？的詳細內容。更多資訊請關注PHP中文網其他相關文章！