Laravel開發：如何使用Laravel Excel實作Excel匯入與匯出？-Laravel-PHP中文網

首頁

php框架

Laravel

Laravel開發：如何使用Laravel Excel實作Excel匯入與匯出？

王林

Jun 13, 2023 pm 02:55 PM

laravelexcel導入excel匯出

Laravel開發：如何使用Laravel Excel實作Excel匯入和匯出？

在開發中，很多時候需要使用到Excel表格進行資料處理，例如資料匯入、匯出等操作。 Laravel Excel是一個簡單而強大的Laravel擴展，它允許我們輕鬆地處理Excel文件，包括Excel文件的讀取、寫入和導出等操作。在本文中，我們將介紹如何使用Laravel Excel實現Excel匯入和匯出。

安裝Laravel Excel

在Laravel專案中使用Laravel Excel非常簡單，只需要在composer.json檔案中加入laravel-excel套件的依賴即可。在命令列中執行以下命令：

composer require maatwebsite/excel

配置Laravel Excel

安裝Laravel Excel後，我們需要進行一些設定才能使用它。首先，在config/app.php檔案中加入以下程式碼：

'providers' => [
    // ...
    MaatwebsiteExcelExcelServiceProvider::class,
  ],

'aliases' => [
    // ...
    'Excel' => MaatwebsiteExcelFacadesExcel::class,
  ],

然後，我們需要發布Laravel Excel的設定文件，執行以下命令：

php artisan vendor:publish --provider="MaatwebsiteExcelExcelServiceProvider" --tag=config

這將在config目錄下生成一個excel.php文件，我們可以在該文件中進行一些配置，例如匯出文件的格式、預設匯出文件名稱等。

Excel檔案匯出

接下來，我們將介紹如何使用Laravel Excel實作Excel檔案的匯出。

3.1 建立匯出類別

首先，我們需要建立一個匯出類，用於定義匯出資料的格式和內容。在命令列中執行以下命令：

php artisan make:export UsersExport --model=User

這將在app/Exports目錄下產生一個UsersExport類，在該類別中可以定義匯出的Excel檔案的資料格式和內容。例如，如果我們要匯出使用者表的數據，可以在該類別中定義如下內容：

namespace AppExports;

use AppModelsUser;
use MaatwebsiteExcelConcernsFromCollection;

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

在上述程式碼中，我們透過FromCollection介面指定了導出的資料來源是User模型中的所有使用者數據。

除了FromCollection接口，Laravel Excel還提供了其他一些接口，例如FromQuery和FromView等，可以根據實際需要選用相應的接口。

3.2 使用匯出類別匯出Excel檔案

定義好匯出類別後，我們可以透過以下程式碼來呼叫匯出類，將資料匯出到Excel檔案：

use AppExportsUsersExport;
use MaatwebsiteExcelFacadesExcel;

public function export()
{
    return Excel::download(new UsersExport, 'users.xlsx');
}

在上述程式碼中，我們使用Excel::download()方法來輸出Excel文件，其中第一個參數為剛剛建立的匯出類別對象，第二個參數是Excel文件的名稱。

Excel檔案匯入

接下來，我們將介紹如何使用Laravel Excel實作Excel檔案的匯入。

4.1 建立導入類別

首先，我們需要建立一個導入類，用於定義導入資料的格式和內容。在命令列中執行以下命令：

php artisan make:import UsersImport --model=User

這將在app/Imports目錄下產生一個UsersImport類，在該類中可以定義導入Excel文件的資料格式和內容。例如，如果我們要匯入使用者表的數據，可以在該類別中定義如下內容：

namespace AppImports;

use AppModelsUser;
use MaatwebsiteExcelConcernsToModel;
use MaatwebsiteExcelConcernsWithHeadingRow;

class UsersImport implements ToModel, WithHeadingRow
{
    public function model(array $row)
    {
        return new User([
            'name'     => $row['name'],
            'email'    => $row['email'],
            'password' => Hash::make($row['password']),
        ]);
    }
}

在上述程式碼中，我們透過ToModel介面將Excel檔案中的每一行資料對應到User模型的屬性上，並透過WithHeadingRow介面指定Excel檔案的第一個行為表頭（即屬性名稱）。

除了ToModel和WithHeadingRow接口，Laravel Excel還提供了其他一些接口，例如ToCollection和ToModel等，可以根據實際需要選用相應的接口。

4.2 使用導入類別導入Excel檔案

定義好導入類別後，我們可以透過以下程式碼來呼叫導入類，將資料從Excel檔案中導入到資料庫中：

use AppImportsUsersImport;
use MaatwebsiteExcelFacadesExcel;

public function import()
{
    Excel::import(new UsersImport, request()->file('file'));

    return redirect()->back();
}

在上述程式碼中，我們使用Excel::import()方法來匯入Excel文件，其中第一個參數為剛剛建立的匯入類別對象，第二個參數為上傳的Excel文件。