Laravel ExcelでExcelファイルを読み書きする簡単アプリの作り方｜ブログ

Laravelで業務アプリを作っていると、「CSV/Excelでデータを出力したい」「Excelを読み込んで一括登録したい」といったニーズ、よくありますよね。 そんな時に大活躍するのが、Laravel Excel パッケージです！ この記事では、Laravel Excelを使って、ユーザー情報の一覧をExcelでエクスポート・インポートできる簡単なアプリの作成方法を紹介します。 なお、本記事はwindows環境での作成を想定しており、composerのインストールが完了しているものとします。 --- 🔧 事前準備 Laravelプロジェクトの作成 bash laravel new excel-demo cd excel-demo Laravel Excelのインストール bash composer require maatwebsite/excel パッケージをインストールするだけで、すぐに使えます。💡 --- 📤 Excelファイルのエクスポート（出力） まずは、ユーザー一覧をExcelで出力する機能から。 1. エクスポート用クラスの作成 bash php artisan make:export UsersExport --model=User 作成された app/Exports/UsersExport.php を以下のように編集します。🖊 php namespace App\Exports; use App\Models\User; use Maatwebsite\Excel\Concerns\FromCollection; use Maatwebsite\Excel\Concerns\WithHeadings; class UsersExport implements FromCollection, WithHeadings { public function collection() { return User::select('name', 'email')->get(); } public function headings(): array { return [ '名前', 'メールアドレス', ]; } } 2. ルートとコントローラーの設定 bash php artisan make:controller ExportController php namespace App\Http\Controllers; use App\Exports\UsersExport; use Maatwebsite\Excel\Facades\Excel; class ExportController extends Controller { public function export() { return Excel::download(new UsersExport, 'users.xlsx'); } } php // web.php Route::get('/export', [ExportController::class, 'export']); ブラウザで /export にアクセスすると、users.xlsx ファイルがダウンロードされます！ --- 📥 Excelファイルのインポート（読み込み） 次は、Excelファイルからユーザーを一括登録する機能です。 1. インポート用クラスの作成 bash php artisan make:import UsersImport --model=User app/Imports/UsersImport.php を編集： php namespace App\Imports; use App\Models\User; use Maatwebsite\Excel\Concerns\ToModel; class UsersImport implements ToModel { public function model(array $row) { return new User([ 'name' => $row[0], 'email' => $row[1], 'password' => bcrypt($row[2]), ]); } } 2. フォームとコントローラー php //routes/web.php use App\Http\Controllers\ImportController; Route::get('/import', function () { return view('import'); }); Route::post('/import', [ImportController::class, 'import'])->name('import'); bash php artisan make:controller ImportController php namespace App\Http\Controllers; use App\Imports\UsersImport; use Illuminate\Http\Request; use Maatwebsite\Excel\Facades\Excel; class ImportController extends Controller { public function import(Request $request) { $request->validate([ 'file' => 'required|file|mimes:xlsx,csv', ]); Excel::import(new UsersImport, $request->file('file')); return redirect('/')->with('success', 'ユーザーをインポートしました！'); } } resources/views/import.blade.php: @csrf アップロードしてインポート ※本記事だけのコードでは実際に登録はされません。必要に応じてDB定義をしてください。 --- ✅ まとめ Laravel Excelを使えば、Excelファイルとの入出力処理が非常に簡単に実装できます。 エクスポート：FromCollection インポート：ToModel この2つのインターフェースを覚えておくだけでも、実務での応用が広がります。 おわりに 以上の手順で、Laravel Excelを使って、ユーザー情報の一覧をExcelでエクスポート・インポートできる簡単なアプリを作成することができました～！ このLaravel Excelですが、結構いろんなことができるんで、気になる方は是非ご自身で調べてみてくださいね～。 それでは、今回はここまで～。