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

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

隨著網路的快速發展，資料的處理越來越重要，特別是在企業的資料管理中。 Excel 檔案已經成為企業辦公室必備的工具之一，因為它可以方便地儲存、編輯、計算和分析資料。 Laravel 是一款被廣泛使用的 PHP 框架，而Laravel Excel 是為 Laravel 開發的 Excel 檔案操作擴充包，它能夠輕鬆實現 Excel 檔案的匯入和匯出。

本文將為您詳細介紹 Laravel Excel 的使用方法。在本文中，我們將學習如何安裝 Laravel Excel 並進行 Excel 檔案的匯入和匯出。

一. 安裝Laravel Excel

在終端機中透過Composer 安裝Laravel Excel

composer require maatwebsite/excel

如果您使用的是Laravel 版本小於5.5，則需要在config/app.php檔案中配置以下兩個服務提供者：

MaatwebsiteExcelExcelServiceProvider::class,

'Excel' => MaatwebsiteExcelFacadesExcel::class,

如果您使用的是Laravel 版本大於或等於5.5，則無需手動新增服務提供者，這些服務提供者會自動新增至設定中。

在終端機中透過Artisan 命令進行發布：

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

這將自動產生以下設定檔和模板檔：

config/excel.php
resources/views/vendor/excel

二. 設定Laravel Excel

設定檔excel.php 包含了Laravel Excel 的所有設定選項。這些選項可以直接在 .env 檔案中定義或在config/excel.php檔案中進行設定。以下是所有可能的選項的詳細描述。

'default_driver' => 'local',

選項「default_driver」指定要使用的預設 driver ，這裡有兩種選擇：local、ftp。

'cache' => [
    'enabled' => true,
    'driver' => 'laravel',
],

選項「cache」指定快取選項，快取可以提高速度，特別是在進行大量資料處理時。當啟用快取時，設定“cache_driver”為“laravel”或“memcached”。

'temp_path' => sys_get_temp_dir(),

選項 temp_path 指定要用於儲存暫存檔案的檔案系統路徑。

'csv' => [
    'delimiter' => ',',
    'enclosure' => '"',
    'escape_character' => '\',
    'input_encoding' => 'UTF-8',
    'output_encoding' => 'UTF-8',
    'use_bom' => false,
],

選項「csv」允許配置 CSV 匯入和匯出的選項，主要有以下選項：

delimiter：分隔符，如：逗號，分號，Tab 等等。

enclosure：列的封閉符號。

escape_character：轉義符。

input_encoding：輸入編碼。

output_encoding：輸出編碼。

use_bom：是否使用 Bom 位元組序。

'exports' => [
    'force_resave' => false,
    'ignore_empty' => false,
    'pre_calculate_formulas' => false,
    'maximum_recursion' => 50,
],

選項「exports」允許設定匯出選項，主要有以下選項：

force_resave：是否強制進行儲存。

ignore_empty：是否忽略空白單元格。

pre_calculate_formulas：是否預先計算公式。

maximum_recursion：遞歸的最大層數。

三. 匯出 Excel 檔案

Laravel Excel 對 Excel 檔案的匯出作業提供了很好的支援。接下來我們將示範如何使用 Laravel Excel 進行資料匯出。

首先，打開控制器文件，建立一個新的Excel 文件並匯出資料：

<?php

namespace AppHttpControllers;

use MaatwebsiteExcelFacadesExcel;
use AppExportsUsersExport;

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

在上面的控制器方法中，我們使用Excel::download()方法建立了一個Excel 檔案。這個方法接受兩個參數：

• 第一個參數 users 將是導出的資料。我們透過建立一個帶有 toExcel() 方法的 UsersExport 輔助類別來實現資料的匯出。
• 第二個參數是檔名，它是必要的。

UsersExport 檔案的內容如下所示：

<?php

namespace AppExports;

use MaatwebsiteExcelConcernsFromCollection;
use AppUser;

class UsersExport implements FromCollection
{
    public function collection()
    {
        return User::select('id', 'name', 'email')->get();
    }
}

這個類別需要實作 MaatwebsiteExcelConcernsFromCollection 介面。我們可以看到 FromCollection 傳回的是一個集合類，其中 get() 方法將傳回該類別中儲存的所有使用者。

這樣，我們就完成了 Laravel Excel 的匯出作業。

四. 匯入 Excel 檔案

Laravel Excel 對 Excel 檔案的匯入操作也提供了非常好的支援。接下來我們將示範如何使用 Laravel Excel 進行 Excel 檔案的資料匯入。

首先，開啟控制器文件，將 Excel 檔案中的資料匯入資料庫：

<?php

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppImportsUsersImport;

class ImportController extends Controller
{
    public function import(Request $request)
    {
        $file = $request->file('file');
        Excel::import(new UsersImport, $file);
        return redirect('/')->with('success', 'Excel 数据已成功导入！');
    }
}

在上面的控制器方法中，我們使用 Excel::import() 方法匯入Excel檔案。這個方法接受兩個參數：

• 第一個參數是 UsersImport，它是導入 Excel 檔案到資料庫中的類別。
• 第二個參數是要匯入的 Excel 文件，它包含要匯入的資料。

現在，讓我們看一下 UsersImport 類別：

<?php

namespace AppImports;

use MaatwebsiteExcelConcernsToModel;
use AppUser;

class UsersImport implements ToModel
{
    public function model(array $row)
    {
        return new User([
            'name' => $row[0],
            'email' => $row[1],
            'password' => bcrypt($row[2])
        ]);
    }
}

如您所見，這個類別需要實作 MaatwebsiteExcelConcernsToModel 接口，這個介面定義了一個 model() 方法。該方法將被用於確定新用戶的屬性。

在 model() 方法中，我們使用陣列的資料行資訊來儲存使用者的屬性。這裡我們在Excel檔案中假設第1行為用戶名，第2行為電子郵箱，第3行為密碼。

這就是我們使用 Laravel Excel 進行 Excel 檔案的匯入和匯出的方式。相信您已經了解了 Laravel Excel 的基本使用方式和一些高級特性。希望這篇文章對您的 Laravel 學習有所幫助。

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