مقاله

نصب Breeze روی Laravel 12، انتخاب Blade یا Livewire، ساختار routeها، login/register و سفارشی‌سازی اولیه.

نصب Laravel Breeze — راهنمای کامل احراز هویت با Blade و Livewire
لاراول

نصب Laravel Breeze — راهنمای کامل احراز هویت با Blade و Livewire

2026/03/27 1 دقیقه مطالعه 5 بازدید Emran Jamshidi
Laravel PHP

Breeze سبک‌ترین starter kit رسمی Laravel برای auth است — نه dashboard سنگین Jetstream، نه از صفر. برای پروژه‌های شرکتی، وبلاگ با پنل، یا MVP فروشگاه، Breeze نقطه شروع استاندارد است. در این راهنما نصب روی Laravel 12 را با stack Blade (و اشاره به Livewire) مرور می‌کنیم.

Breeze چه می‌دهد؟

  • ثبت‌نام، ورود، خروج
  • فراموشی و reset رمز
  • تأیید ایمیل (اختیاری)
  • پروفایل کاربر پایه
  • middleware auth و viewهای آماده

مستندات: Laravel Breeze.

پیش‌نیاز

پروژه Laravel نصب‌شده، Composer، Node.js. اگر تازه شروع کردید: نصب Laravel و Composer.

نصب

composer require laravel/breeze --dev
php artisan breeze:install

# انتخاب stack:
# blade / livewire / react / vue / api

npm install
npm run build
php artisan migrate

برای monolith سنتی Blade کافی است. Livewire وقتی فرم‌های تعاملی بدون SPA می‌خواهید.

ساختار بعد از نصب

  • routes/auth.php — مسیرهای login/register
  • app/Http/Controllers/Auth/*
  • resources/views/auth/*
  • app/Http/Requests/Auth/* — validation

با Route و Controller و ساختار پوشه‌ها هم‌خوان است.

محافظت route

Route::middleware(['auth', 'verified'])->group(function () {
    Route::get('/dashboard', fn () => view('dashboard'));
});

سفارشی‌سازی

viewها را با Tailwind و Blade component ویرایش کنید. منطق auth را در Controller نگه دارید — business logic در Service. فیلد extra (مثلاً phone) به migration users و Form Request اضافه شود.

Breeze vs Sanctum-only

Breeze برای وب session-based. API موبایل: Breeze stack api یا جدا Sanctum.

امنیت

اشتباهات

ویرایش مستقیم vendor. حذف middleware auth از dashboard by mistake. فراموش npm run build بعد از تغییر asset.

جمع‌بندی

Breeze = auth استاندارد سریع. بعد از نصب: Policy برای مجوز، session vs token برای معماری.

پروژه با پنل کاربری

مقالات مرتبط