使用Laravel Excel快速導出數據到Excel表格

一、項目背景

Laravel是一個流行的PHP框架，它提供了輕鬆構建Web應用程序所需的工具和功能。然而，在某些情況下，我們需要從Web應用程序中導出數據並生成Excel表格，而Laravel框架並沒有這個功能。因此，我們需要使用第三方擴展庫Laravel Excel來快速導出數據到Excel表格。

二、安裝Laravel Excel擴展庫

安裝Laravel Excel非常簡單，只需在終端中執行以下命令：

composer require maatwebsite/excel

當安裝完成後，我們需要向Laravel註冊擴展庫。打開config/app.php文件，在providers數組中添加以下代碼：

'providers' => [
    // ...
    Maatwebsite\Excel\ExcelServiceProvider::class,
]

在aliases數組中也需要添加以下配置代碼：

'aliases' => [
    // ...
    'Excel' => Maatwebsite\Excel\Facades\Excel::class,
]

三、導出Excel表格

1.簡單例子

為了說明如何使用Laravel Excel庫快速導出數據到Excel表格，我們來看一個簡單的例子。首先，我們需要創建一個控制器：

php artisan make:controller ExportController

然後打開ExportController.php文件，添加以下代碼：

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Maatwebsite\Excel\Facades\Excel;

class ExportController extends Controller
{
    public function export()
    {
        $data = [
            ['id' => 1, 'name' => 'John'],
            ['id' => 2, 'name' => 'Jane'],
            ['id' => 3, 'name' => 'Steve'],
            ['id' => 4, 'name' => 'Marius'],
        ];

        return Excel::download(new UsersExport($data), 'users.xlsx');
    }
}

導出的數據保存在$data數組變數中，並且我們將使用Export類將數據導出到Excel文件。最後，我們將文件保存為users.xlsx。我們只需要添加一個按鈕到我們的視圖中，調用export()函數即可實現文件導出：

<a href="{{ route('export') }}">Export</a>

我們需要創建一個Export類，打開終端，執行以下命令：

php artisan make:export UsersExport --model=User

這將創建一個名為UsersExport的類，並在其中添加導出Excel文件所需的函數：

namespace App\Exports;

use App\Models\User;
use Maatwebsite\Excel\Concerns\FromCollection;

class UsersExport implements FromCollection
{
    public function __construct(array $data)
    {
        $this->data = $data;
    }

    public function collection()
    {
        return collect($this->data);
    }
}

現在我們就可以使用以下命令在瀏覽器中運行export()函數，該函數將導出數據並保存到users.xlsx文件中：

php artisan serve

2.增加樣式

我們可以很容易地嚮導出的Excel文件中添加樣式，只需在Export類中添加一個函數即可：

public function headings(): array
{
    return [
        'ID', 'Name'
    ];
}

public function styles(Worksheet $sheet)
{
    $cellRange = 'A1:B1';  // 選擇要設置樣式的範圍
    $sheet->getStyle($cellRange)->applyFromArray([
        'font' => [
            'bold' => true
        ]
    ]);
}

3.使用多個表格

有時，我們需要將多個表格導出到單個Excel文件中。這也很容易實現，只需在Export類中添加另一個函數即可：

namespace App\Exports;

use Illuminate\Support\Collection;
use Maatwebsite\Excel\Concerns\Exportable;
use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\WithMultipleSheets;

class UsersExport implements FromCollection, WithMultipleSheets
{
    use Exportable;

    protected $data;

    public function __construct(array $data)
    {
        $this->data = $data;
    }

    public function collection()
    {
        return collect($this->data);
    }

    public function sheets(): array
    {
        $sheets = [];

        $sheets[] = new UsersSheet($this->data);
        $sheets[] = new OrdersSheet($this->data);

        return $sheets;
    }
}

class UsersSheet implements FromCollection
{
    public function __construct(array $data)
    {
        $this->data = $data;
    }

    public function collection()
    {
        return collect($this->data);
    }

    public function headings(): array
    {
        return ['ID', 'Name'];
    }
}

class OrdersSheet implements FromCollection
{
    public function __construct(array $data)
    {
        $this->data = $data;
    }

    public function collection()
    {
        return collect($this->data);
    }

    public function headings(): array
    {
        return ['Order ID', 'Amount'];
    }
}

在以上例子中，我們創建了一個名為UsersSheet的類和一個名為OrdersSheet的類，每個類都創建了自己的表格。然後，我們可以使用sheets()函數將它們組合在一起並導出到單個Excel文件中。

四、總結

使用Laravel Excel擴展庫可以輕鬆地將數據導出到Excel表格中，而且也非常容易添加樣式和多個表，非常方便。希望大家可以根據本文提供的方法實踐開發，以便更好的了解和掌握Laravel Excel的應用。