پکیج breeze لاراول

Laravel Breeze یک پیاده‌سازی ساده و ساده از تمام ویژگی‌های احراز هویت لاراول، از جمله ورود، ثبت نام، تنظیم مجدد رمز عبور، تأیید ایمیل و تأیید رمز عبور است. علاوه بر این، Breeze شامل یک صفحه “پروفایل” ساده است که در آن کاربر می تواند نام، آدرس ایمیل و رمز عبور خود را به روز کند. لایه ی نمای پیش‌فرض لاراول بریز از قالب‌های ساده Blade تشکیل شده است که با Tailwind CSS طراحی شده‌اند. علاوه بر این، Breeze گزینه‌های داربست مبتنی بر Livewire یا Inertia را با انتخاب استفاده از Vue یا React برای داربست مبتنی بر اینرسی ارائه می‌کند.

نصب و راه اندازی

ابتدا باید یک برنامه جدید لاراول ایجاد کنید. اگر برنامه خود را با استفاده از نصب کننده لاراول ایجاد کنید، در طول مراحل نصب از شما خواسته می شود که Laravel Breeze را نصب کنید. در غیر این صورت، باید دستورالعمل نصب دستی زیر را دنبال کنید. اگر قبلاً یک برنامه جدید لاراول بدون کیت شروع ایجاد کرده اید، می توانید Laravel Breeze را به صورت دستی با استفاده از Composer نصب کنید:

composer require laravel/breeze --dev

پس از اینکه Composer بسته Laravel Breeze را نصب کرد، باید دستور breeze:install Artisan را اجرا کنید. این دستور نماهای احراز هویت، مسیرها، کنترلرها و سایر منابع را برای برنامه شما منتشر می کند. Laravel Breeze تمام کدهای خود را در برنامه شما منتشر می کند تا کنترل و دید کاملی بر روی ویژگی ها و پیاده سازی آن داشته باشید. دستور breeze:install از شما می‌خواهد که پشته و چارچوب آزمایشی دلخواه خود را انتخاب کنید:

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

«پشته» پیش‌فرض Breeze پشته Blade است که از قالب‌های ساده Blade برای رندر کردن ظاهر برنامه شما استفاده می‌کند. پشته Blade ممکن است با فراخوانی دستور breeze:install بدون هیچ آرگومان اضافی دیگری و انتخاب پشته Blade frontend نصب شود. پس از نصب داربست Breeze، باید قسمت های ظاهری برنامه خود را نیز کامپایل کنید:

در مرحله بعد، می توانید به آدرس /login یا /register برنامه خود در مرورگر وب خود بروید. تمام مسیرهای Breeze در فایل routes/auth.php تعریف شده اند.

لاراول Breeze چهار چوب Livewire را نیز ارائه می دهد. Livewire یک راه قدرتمند برای ساختن رابط‌های کاربری پویا، واکنش‌گرا و ui فقط با استفاده از PHP است. Livewire برای تیم هایی که عمدتاً از قالب های Blade استفاده می کنند مناسب است و به دنبال جایگزین ساده تری برای چارچوب های SPA مبتنی بر جاوا اسکریپت مانند Vue و React هستند. برای استفاده از پشته Livewire، هنگام اجرای دستور breeze:install Artisan، می توانید پشته Frontend Livewire را انتخاب کنید. پس از نصب داربست Breeze، باید migration های پایگاه داده خود را اجرا کنید:

php artisan breeze:install
 
php artisan migrate

Laravel Breeze همچنین داربست های React و Vue را از طریق اجرای Inertia frontend ارائه می دهد. Inertia به شما امکان می دهد برنامه های React و Vue مدرن و تک صفحه ای را با استفاده از مسیریابی و کنترلرهای کلاسیک سمت سرور بسازید. Inertia به شما امکان می دهد از قدرت ظاهری React و Vue همراه با بهره وری باورنکردنی باطن لاراول و کامپایل Vite با سرعت رعد و برق لذت ببرید. برای استفاده از پشته Inertia، هنگام اجرای دستور breeze:install Artisan، می توانید پشته های Vue یا React frontend را انتخاب کنید. هنگام انتخاب پشته Vue یا React frontend، نصب کننده Breeze همچنین از شما می خواهد تعیین کنید که آیا مایل به پشتیبانی Inertia SSR یا TypeScript هستید یا خیر. پس از نصب داربست Breeze، باید دارایی های ظاهری برنامه خود را نیز کامپایل کنید:

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

Laravel Breeze همچنین می‌تواند یک API احراز هویت را ایجاد کند که برای تأیید اعتبار برنامه‌های جاوا اسکریپت مدرن مانند برنامه‌هایی که توسط Next، Nuxt و سایرین پشتیبانی می‌شوند، آماده است. برای شروع، هنگام اجرای دستور breeze:install Artisan، پشته API را به عنوان پشته مورد نظر خود انتخاب کنید:

php artisan breeze:install

php artisan migrate

در طول نصب، Breeze یک متغیر محیطی FRONTEND_URL را به فایل env. برنامه شما اضافه می کند. این URL باید URL برنامه جاوا اسکریپت شما باشد. این معمولاً در طول توسعه محلی http://localhost:3000 خواهد بود. علاوه بر این، باید اطمینان حاصل کنید که APP_URL شما روی http://localhost:8000 تنظیم شده است، که URL پیش فرض استفاده شده توسط دستور serve Artisan است.