حالا بریم سراغ یکی از پکیج‌های فوق‌العاده محبوب در لاراول برای کار با فایل‌های اکسل:

📊 Laravel Excel

توسط Maatwebsite ساخته شده و بر پایه PHPSpreadsheet عمل می‌کنه.

📦 نصب پکیج

bash
CopyEdit
composer require maatwebsite/excel

(لاراول 9 به بالا کاملاً سازگاره)

📁 ایجاد Export (خروجی گرفتن از اکسل)

1. ساخت کلاس Export:

bash
CopyEdit
php artisan make:export UsersExport --model=User

2. محتوای کلاس UsersExport.php:

php
CopyEdit
namespace App\Exports;

use App\Models\User;
use Maatwebsite\Excel\Concerns\FromCollection;

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

3. استفاده در کنترلر:

php
CopyEdit
use App\Exports\UsersExport;
use Maatwebsite\Excel\Facades\Excel;

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

📥 ایجاد Import (ورودی گرفتن فایل اکسل)

1. ساخت کلاس Import:

bash
CopyEdit
php artisan make:import UsersImport --model=User

2. محتوای UsersImport.php:

php
CopyEdit
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]),
        ]);
    }
}

3. استفاده در کنترلر:

php
CopyEdit
use App\Imports\UsersImport;
use Maatwebsite\Excel\Facades\Excel;

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

    return back()->with('success', 'کاربران با موفقیت وارد شدند!');
}

🧰 امکانات اضافی

✨ مثال با هدر

php
CopyEdit
use Maatwebsite\Excel\Concerns\WithHeadings;

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

    public function headings(): array
    {
        return ['ID', 'نام', 'ایمیل'];
    }
}

🛠 مسیر آپلود فایل در فرم Blade

blade
CopyEdit
<form action="{{ route('import') }}" method="POST" enctype="multipart/form-data">
    @csrf
    <input type="file" name="file">
    <button type="submit">آپلود فایل اکسل</button>
</form>

📁 جمع‌بندی