摘要：文檔示例注意你必須通過安裝指定的包，比如導(dǎo)出的如下所示按需格式化單元格有一個(gè)強(qiáng)有力的爸爸。因此它就擁有其各種底層功能，包括各種方式的單元格格式化。

Laravel Excel package 最近發(fā)布了 3.0 版本，它所具有的新功能，可以幫助簡(jiǎn)化高級(jí)需求，并且可用性極高。大家一起來探討一下可能不知道的一些隱藏功能，這些功能使 Laravel Excel 成為 Excel 拓展的最佳首選。

假設(shè)已經(jīng)有一個(gè) 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 }}
    

你可以使用它去重復(fù)導(dǎo)入這個(gè)表格到 Excel

步驟1. 生成一個(gè) Export 類

php artisan make:export CustomersFromView --model=Customer

步驟2. 使用 FromView 進(jìn)行操作

namespace AppExports;

use AppCustomer;
use IlluminateContractsViewView;
use MaatwebsiteExcelConcernsFromView;

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

這里是導(dǎo)入的 Excel 文件：

注意：這里只能導(dǎo)出 HTML 表格，不能具有任何標(biāo)簽，比如 html，body，div 等。

*

雖然包的名稱是 Laravel Excel，但是提供了多種導(dǎo)出格式，并且使用起來十分簡(jiǎn)單，只要在類里再添加一個(gè)參數(shù)即可：

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

比如這么做，就導(dǎo)出到了HTML，如下圖所示：

沒有太多的樣式，下面是源代碼：

不僅如此，它還可以導(dǎo)出到 PDF，甚至你可以從中選擇三種庫，使用方法是一樣的，你只要在最后一個(gè)參數(shù)指定格式就好了，下面是一些例子。?文檔示例:

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

composer require dompdf/dompdf

導(dǎo)出的 PDF 如下所示：

*

Laravel Excel 有一個(gè)強(qiáng)有力的「爸爸」 --?PhpSpreadsheet。因此它就擁有其各種底層功能，包括各種方式的單元格格式化。

此處是一個(gè)如何在 Laravel Export 類中使用它的例子，例如?app/Exports/CustomersExportStyling.php：

步驟 1.?在頭部引入適當(dāng)?shù)念悺?/p>

use MaatwebsiteExcelConcernsWithEvents;
use MaatwebsiteExcelEventsAfterSheet;

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

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

步驟 3.?用 AfterSheet 事件來創(chuàng)建?registerEvents()?方法。

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

這里有個(gè)例子：

/**
 * @return array
 */
public function registerEvents(): array
{
    return [
        AfterSheet::class    => function(AfterSheet $event) {
            // 所有表頭-設(shè)置字體為14
            $cellRange = "A1:W1";
            $event->sheet->getDelegate()->getStyle($cellRange)->getFont()->setSize(14);

            // 將樣式數(shù)組應(yīng)用于B2：G8范圍單元格
            $styleArray = [
                "borders" => [
                    "outline" => [
                        "borderStyle" => PhpOfficePhpSpreadsheetStyleBorder::BORDER_THICK,
                        "color" => ["argb" => "FFFF0000"],
                    ]
                ]
            ];
            $event->sheet->getDelegate()->getStyle("B2:G8")->applyFromArray($styleArray);

            // 將第一行行高設(shè)置為20
            $event->sheet->getDelegate()->getRowDimension(1)->setRowHeight(20);

            // 設(shè)置 A1:D4 范圍內(nèi)文本自動(dòng)換行
            $event->sheet->getDelegate()->getStyle("A1:D4")
                ->getAlignment()->setWrapText(true);
        },
    ];
}

這些「隨機(jī)」樣例展示的結(jié)果如下所示：

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

*

假設(shè)我們已經(jīng)創(chuàng)建了Laravel 5.7默認(rèn)的users表:

現(xiàn)在我們嘗試用簡(jiǎn)單的FromCollection來導(dǎo)出用戶表數(shù)據(jù)：

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

在導(dǎo)出的Excel 里，你只能看到如下字段，但是沒有password和remember_token：

這是因?yàn)樵?b>User模型里定義了隱藏字段的屬性：

class User extends Authenticatable
{
    // ...

    /**
     * 這個(gè)數(shù)組用來定義需要隱藏的字段。
     *
     * @var array
     */
    protected $hidden = [
        "password", "remember_token",
    ];
}

所以，默認(rèn)情況下這些字段是隱藏的，如果你想在導(dǎo)出數(shù)據(jù)的時(shí)候某些字段不被導(dǎo)出的話，可以直接在模型中定義隱藏屬性$hidden。

*

出于某種原因，Laravel Excel 包的官方文檔中并沒有提及公式，但是這是Excel 重要的功能！

幸運(yùn)的是，我們可以直接將公式寫在導(dǎo)出數(shù)據(jù)的類中，我們需要設(shè)置cell 的值，就像這樣：=A2+1 or SUM(A1:A10)。

其中一種方式就是實(shí)現(xiàn)WithMapping 接口：

use AppCustomer;
use MaatwebsiteExcelConcernsFromCollection;
use MaatwebsiteExcelConcernsWithMapping;

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的五個(gè)鮮為人知的功能。

文章轉(zhuǎn)自： https://learnku.com/laravel/t... 

更多文章：https://learnku.com/laravel/c...