Laravel Excel 教學：從入門到精通

“`html

Laravel Excel 安裝與設定

Laravel Excel 是一個功能強大且廣泛使用的 Excel 處理套件。在 Laravel 中使用 Laravel Excel 可以讓我們輕鬆地導入和導出 Excel 文件。以下是如何在你的 Laravel 項目中安裝和設定 Laravel Excel 的詳細步驟。

步驟 1: 安裝 Laravel Excel 套件

首先，你需要使用 Composer 來安裝 Laravel Excel 套件。在你的終端機中運行以下命令：

composer require maatwebsite/excel

步驟 2: 註冊服務提供者 (Service Provider)

如果你使用的是 Laravel 5.5 及以上的版本，則自動包發現 (Package Discovery) 將自動進行，不需要手動註冊服務提供者。如果你使用的是更低的版本，則需要在 config/app.php 文件中手動註冊服務提供者：

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

步驟 3: 發佈配置 (Publishing Configuration)

接著，你可以選擇發佈 Laravel Excel 的配置文件，以便進行自定義配置。運行以下命令來發佈配置：

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

這將在你的應用程序中創建一個 config/excel.php 文件，你可以在此文件中進行相關設置。

導入 Excel 文件

一旦安裝和設定完成，我們就可以開始導入 Excel 文件。以下是如何在 Laravel 中使用 Laravel Excel 來導入 Excel 文件的詳細步驟。

步驟 1: 創建導入文件 (Import Class)

首先，我們將創建一個導入文件來處理 Excel 文件的導入。在終端機中運行以下命令：

php artisan make:import UsersImport --model=User

這個命令將創建一個名為 UsersImport 的導入文件，並且自動引入 User 模型。

步驟 2: 實作導入邏輯

接著，我們需要在 app/Imports/UsersImport.php 文件中實作導入邏輯。編輯該文件，並添加以下代碼：

namespace AppImports;

use AppModelsUser;
use MaatwebsiteExcelConcernsToModel;

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

步驟 3: 控制器中導入文件

最後，我們需要在控制器中調用這個導入文件。在控制器中添加以下代碼來處理文件上傳和導入：

namespace AppHttpControllers;

use AppImportsUsersImport;
use MaatwebsiteExcelFacadesExcel;
use IlluminateHttpRequest;

class UserController extends Controller
{
    public function import(Request $request)
    {
        Excel::import(new UsersImport, $request->file('file'));

        return back()->with('success', 'All good!');
    }
}

導出 Excel 文件

與導入相似，導出 Excel 文件也相當簡單。以下是如何在 Laravel 中使用 Laravel Excel 來導出 Excel 文件的詳細步驟。

步驟 1: 創建導出文件 (Export Class)

首先，我們將創建一個導出文件來處理 Excel 文件的導出。在終端機中運行以下命令：

php artisan make:export UsersExport --model=User

這個命令將創建一個名為 UsersExport 的導出文件，並且自動引入 User 模型。

步驟 2: 實作導出邏輯

接著，我們需要在 app/Exports/UsersExport.php 文件中實作導出邏輯。編輯該文件，並添加以下代碼：

namespace AppExports;

use AppModelsUser;
use MaatwebsiteExcelConcernsFromCollection;

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

步驟 3: 控制器中導出文件

最後，我們需要在控制器中調用這個導出文件。在控制器中添加以下代碼來處理文件導出：

namespace AppHttpControllers;

use AppExportsUsersExport;
use MaatwebsiteExcelFacadesExcel;
use IlluminateHttpRequest;

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

結論

使用 Laravel Excel，可以方便地在 Laravel 應用程序中進行 Excel 文件的導入和導出操作。希望本教學能夠幫助你快速上手 Laravel Excel。

“`