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

隨著網(wǎng)路的快速發(fā)展，資料的處理越來越重要，特別是在企業(yè)的資料管理中。 Excel 檔案已經(jīng)成為企業(yè)辦公室必備的工具之一，因?yàn)樗梢苑奖愕貎?chǔ)存、編輯、計(jì)算和分析資料。 Laravel 是一款被廣泛使用的 PHP 框架，而Laravel Excel 是為 Laravel 開發(fā)的 Excel 檔案操作擴(kuò)充包，它能夠輕鬆實(shí)現(xiàn) Excel 檔案的匯入和匯出。

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

一. 安裝Laravel Excel

在終端機(jī)中透過Composer 安裝Laravel Excel

composer require maatwebsite/excel

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

MaatwebsiteExcelExcelServiceProvider::class,

'Excel' => MaatwebsiteExcelFacadesExcel::class,

如果您使用的是Laravel 版本大於或等於5.5，則無需手動(dòng)新增服務(wù)提供者，這些服務(wù)提供者會(huì)自動(dòng)新增至設(shè)定中。

在終端機(jī)中透過Artisan 命令進(jìn)行發(fā)布：

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

這將自動(dòng)產(chǎn)生以下設(shè)定檔和模板檔：

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

二. 設(shè)定Laravel Excel

設(shè)定檔excel.php 包含了Laravel Excel 的所有設(shè)定選項(xiàng)。這些選項(xiàng)可以直接在 .env 檔案中定義或在config/excel.php檔案中進(jìn)行設(shè)定。以下是所有可能的選項(xiàng)的詳細(xì)描述。

'default_driver' => 'local',

選項(xiàng)「default_driver」指定要使用的預(yù)設(shè) driver ，這裡有兩種選擇：local、ftp。

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

選項(xiàng)「cache」指定快取選項(xiàng)，快取可以提高速度，特別是在進(jìn)行大量資料處理時(shí)。當(dāng)啟用快取時(shí)，設(shè)定“cache_driver”為“l(fā)aravel”或“memcached”。

'temp_path' => sys_get_temp_dir(),

選項(xiàng) temp_path 指定要用於儲(chǔ)存暫存檔案的檔案系統(tǒng)路徑。

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

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

delimiter：分隔符，如：逗號(hào)，分號(hào)，Tab 等等。

enclosure：列的封閉符號(hào)。

escape_character：轉(zhuǎn)義符。

input_encoding：輸入編碼。

output_encoding：輸出編碼。

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

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

選項(xiàng)「exports」允許設(shè)定匯出選項(xiàng)，主要有以下選項(xiàng)：

force_resave：是否強(qiáng)制進(jìn)行儲(chǔ)存。

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

pre_calculate_formulas：是否預(yù)先計(jì)算公式。

maximum_recursion：遞歸的最大層數(shù)。

三. 匯出 Excel 檔案

Laravel Excel 對(duì) Excel 檔案的匯出作業(yè)提供了很好的支援。接下來我們將示範(fàn)如何使用 Laravel Excel 進(jìn)行資料匯出。

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

<?php

namespace AppHttpControllers;

use MaatwebsiteExcelFacadesExcel;
use AppExportsUsersExport;

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

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

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

UsersExport 檔案的內(nèi)容如下所示：

<?php

namespace AppExports;

use MaatwebsiteExcelConcernsFromCollection;
use AppUser;

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

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

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

四. 匯入 Excel 檔案

Laravel Excel 對(duì) Excel 檔案的匯入操作也提供了非常好的支援。接下來我們將示範(fàn)如何使用 Laravel Excel 進(jìn)行 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 數(shù)據(jù)已成功導(dǎo)入！');
    }
}

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

• 第一個(gè)參數(shù)是 UsersImport，它是導(dǎo)入 Excel 檔案到資料庫中的類別。
• 第二個(gè)參數(shù)是要匯入的 Excel 文件，它包含要匯入的資料。

現(xiàn)在，讓我們看一下 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])
        ]);
    }
}

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

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

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

以上是Laravel開發(fā)：如何使用Laravel Excel匯入和匯出Excel檔案？的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！