آموزش نصب و راه اندازی پکیج Laravel Breeze در لاراول
ایجاد سیستم احراز هویت (ثبتنام، ورود، بازیابی رمز عبور و تایید ایمیل) همیشه یکی از مراحل اولیه و تکراری در توسعه وبسایتها بوده است. فریمورک لاراول برای سرعت بخشیدن به این مسیر، استارترکیتهای فوقالعادهای ارائه داده که محبوبترین و سبکترین آنها Laravel Breeze است. این پکیج کاملاً مینیمال طراحی شده و تمامی کدهای احراز هویت را به صورت شفاف و قابل تغییر در اختیار شما قرار میدهد تا کنترل کاملی روی ساختار پروژه داشته باشید.
هر توسعه دهنده Laravel یا Backend Developer که قصد دارد یک طراحی سایت شرکتی، یک طراحی فروشگاه اینترنتی یا یک طراحی پنل مدیریت را آغاز کند، میتواند با استفاده از باریز در چند دقیقه زیرساخت سیستم امنیتی پروژه خود را پیادهسازی کند. پکیج Breeze افزون بر قالبهای سنتی Blade، از استکهای مدرنی مثل Livewire، فریمورکهای کامپوننتمحور React / Vue با Inertia.js و حتی حالت REST API برای برنامههای Next.js پشتیبانی میکند. در ادامه مراحل کامل نصب و راهاندازی این پکیج را بررسی میکنیم.
🚀 بخش ۱: نصب پکیج Breeze از طریق Composer
ابتدا باید پکیج Breeze را به عنوان یک وابستگی توسعه (Dev Dependency) به پروژه لاراولی خود اضافه کنید. برای این کار ترمینال را در مسیر پروژه باز کرده و دستور زیر را اجرا کنید:
۱. دانلود پکیج با Composer
دستور زیر آخرین نسخه از Laravel Breeze را روی پروژه شما دانلود و آماده نصب میکند:
composer require laravel/breeze --dev🛠️ بخش ۲: انتخاب استک و اجرای دستور breeze:install
پس از دانلود پکیج، باید دستور نصب اختصاصی Breeze را اجرا کنید. این دستور یک منوی تعاملی باز کرده و از شما میپرسد که مایلید از چه استک فرانتاَندی در پروژه خود استفاده کنید.
۲. اجرای فرمان اصلی نصب
فرمان زیر را در ترمینال بزنید تا مراحل کانفیگ تعاملی آغاز شود:
php artisan breeze:install💡 راهنمای انتخاب استک مناسب پروژه شما
گزینه blade
برای پروژههای استاندارد و ساده لاراولی که با قالبهای سنتّی Blade و Alpine.js کار میکنند (بهترین انتخاب برای شروع).
گزینه livewire
برای ساخت برنامههای تعاملی و پویا بدون درگیر شدن با جاوااسکریپت و فریمورکهای پیچیده فرانتاند.
گزینههای react / vue
اگر قصد ساخت اپلیکیشنهای Single Page (SPA) مدرن را دارید و میخواهید از فریمورکهای Vue یا React در کنار Inertia.js استفاده کنید.
گزینه api
اگر فرانتاند پروژه شما کاملاً مجزاست (مثلاً با Next.js یا Nuxt توسعه داده شده) و لاراول فقط نقش ارائه APIهای احراز هویت را بر عهده دارد.
🧪 انتخاب فریمورک تستنویسی (Testing Framework)
در ادامه مراحل نصب، ترمینال از شما میپرسد که قصد دارید از کدام ابزار برای تستنویسی خودکار کدهای احراز هویت استفاده کنید:
گزینه PHPUnit (کلاسیک و استاندارد)
ابزار استاندارد و قدیمی تستنویسی در PHP که ساختاری بر پایه کلاسها دارد. اگر قبلاً با PHPUnit کار کردهاید یا پروژهتان سنتی است این گزینه را انتخاب کنید.
گزینه Pest (مدرن و پیشنهادی)
فریمورک تستنویسی مدرن و فوقالعاده سریع با سینتکس بسیار تمیز و خوانا که توسعهدهندگان لاراول عاشقش هستند. برای پروژههای جدید بهترین انتخاب است.
🎨 بررسی گزینههای مختلف استک در Laravel Breeze
بسته به این که پروژه شما یک ساخت سامانه آنلاین ساده است یا یک وباپلیکیشن مدرن، میتوانید یکی از استکهای زیر را در زمان اجرای دستور بالایی انتخاب کنید:
استک اول: Blade (گزینه استاندارد و ساده)
این استک از ویوهای ساده Blade همراه با Tailwind CSS استفاده میکند. برای راهاندازی آن کافی است پس از انتخاب Blade، دستورات زیر را برای مایگرید کردن دیتابیس و کامپایل فایلهای CSS اجرا کنید:
php artisan migrate
npm install
npm run devاستک دوم: Livewire (تعاملی و بدون نیاز به JS)
اگر میخواهید بدون درگیر شدن با فریمورکهای جاوااسکریپتی، کامپوننتهای زنده و تعاملی بسازید، استک Livewire عالی است. بعد از انتخاب این استک، فقط کافی است مایگریشنها را اجرا کنید:
php artisan migrateاستک سوم: Vue / React به همراه Inertia.js
اگر قصد توسعه SPA با ریاکت یا ویو را دارید بدون اینکه درگیر Routing پیچیده سمت فرانت شوید، Inertia بهترین انتخاب است. در زمان نصب میتوانید پشتیبانی از TypeScript یا SSR را هم فعال کنید:
php artisan migrate
npm install
npm run devاستک چهارم: حالت API برای Next.js / Nuxt
اگر به عنوان بکاند کار قصد دارید فقط APIهای مربوط به احراز هویت را برای یک اپلیکیشن فرانت جداگانه (مثل Next.js) فراهم کنید، این گزینه را انتخاب کنید. در این حالت متغیر FRONTEND_URL به فایل .env شما اضافه میشود که باید آدرس فرانتانداز شما (مثلا http://localhost:3000) در آن ست شود:
php artisan migrate🔐 تست و دسترسی به مسیرهای احراز هویت
تست مسیرها در مرورگر
پس از اجرای مراحل فوق، مسیرهای احراز هویت مثل /login و /register در پروژه شما فعال میشوند. تمام روتهای مربوط به سیستم لاگین و ثبت نام در فایل routes/auth.php قرار گرفتهاند و به راحتی قابل سفارشیسازی هستند.
🛠️ جمعبندی؛ شروع یک توسعه سریع و ایمن
نکته پایانی برای توسعهدهندگان
پکیج Breeze برخلاف پکیجهای سنگینتر، هیچ کد پنهان یا پیچیدهای در موتور لاراول باقی نمیگذارد؛ تمام کنترلرها، روتها و ویوها به پروژه شما منتقل میشوند. این ابزار بهترین نقطه شروع برای رعایت استانداردهای Laravel Security و پیادهسازی سریع احراز هویت در پروژه شماست تا وقت خود را صرف توسعه بخشهای اصلی پروژه مثل طراحی API یا منطق اصلی کسبوکار کنید.