Laravel開發：如何使用Laravel Excel匯入和匯出CSV檔案？

Laravel是業界比較出色的PHP框架之一，其強大的功能和易於使用的API使得其深受開發者的喜愛。在實際開發中，我們經常需要進行資料的匯入和匯出工作，而CSV作為一種廣泛應用的資料格式，也成為了常用的匯入和匯出格式之一。本文將介紹如何使用 Laravel Excel擴充來進行 CSV 檔案的匯入和匯出操作。

一、安裝Laravel Excel

首先，我們需要使用Composer來安裝Laravel Excel：

composer require maatwebsite/excel

安裝完成後，我們需要在config/app.php 檔案中添加以下程式碼到providers 陣列：

MaatwebsiteExcelExcelServiceProvider::class,

將以下程式碼新增以下程式碼到aliases 陣列：

'Excel' => MaatwebsiteExcelFacadesExcel::class,

二、匯出CSV檔案

假設我們有一個使用者模型User ，它有一個getExportData() 方法，該方法傳回了要匯出的資料。那我們可以這樣寫匯出程式碼：

use MaatwebsiteExcelFacadesExcel;
use AppModelsUser;

class UserController extends Controller
{
    public function exportUsers()
    {
        return Excel::download(new UserExport(), 'users.csv');
    }
}

class UserExport implements FromQuery, WithHeadings
{
    public function query()
    {
        return User::query();
    }

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

在上面的程式碼中，我們使用了 Laravel Excel 的 FromQuery 和 WithHeadings 介面來快速匯出資料到 CSV 檔案。 FromQuery 介面需要實作一個 query() 方法，傳回要匯出的資料集合；WithHeadings 介面需要實作一個 headings() 方法，傳回 CSV 檔案的表頭資訊。在匯出操作中，我們使用 Excel::download() 方法來進行下載，傳入兩個參數：匯出類別 UserExport 和檔案名稱 users.csv 。

當使用者存取該路由時，就可以直接下載匯出的CSV檔案了。

三、導入CSV文件

要導入CSV文件，我們需要寫一個導入類別並實作 FromCollection 介面。

假設我們有一個 User 匯入模型，其中有一個 importUsers() 方法，該方法接受一個上傳的 CSV 文件，並將資料匯入到資料庫中。我們可以這樣寫：

use MaatwebsiteExcelFacadesExcel;
use AppModelsUser;

class UserController extends Controller
{
    public function importUsers(Request $request)
    {
        $request->validate([
            'file' => 'required|mimes:csv,txt',
        ]);

        $path = $request->file('file')->getRealPath();
        $data = Excel::import(new UserImport(), $path);

        return redirect()->back()->with('success', '导入成功');
    }
}

class UserImport implements FromCollection
{
    public function collection(Collection $rows)
    {
        foreach ($rows as $row) {
            User::create([
                'name' => $row[0],
                'email' => $row[1],
            ]);
        }
    }
}

在上面的程式碼中，我們定義了一個 UserImport 類別並實作了 FromCollection 介面。這裡的 collection() 方法用於處理從CSV檔案匯入的數據，將其轉換為 Collection 物件。在這個例子中，我們簡單地創建了一個用戶，並用文件中的第一列作為用戶名，第二列作為郵箱地址。

在實作導入功能時，我們需要使用 Excel::import() 方法來傳入導入類別和檔案路徑。該方法將返回導入資料的數組，我們可以將其傳遞到其他處理器中。

四、總結

使用 Laravel Excel 擴展，我們可以輕鬆地將 CSV 資料匯入和匯出到 Laravel 應用程式中。在上面的範例中，我們使用了 FromQuery、WithHeadings 和 FromCollection 介面來實作資料的匯出和匯入。當然，Laravel Excel 也支援其他接口，如 FromArray、WithTitle、WithMapping 等。在實際專案中，我們可以根據實際需求選擇合適的介面來完成特定的資料匯入和匯出工作。

以上是Laravel開發：如何使用Laravel Excel匯入和匯出CSV檔案？的詳細內容。更多資訊請關注PHP中文網其他相關文章！