کیت های شروع

معرفی
لاراول بریز
لاراول جت استریم

معرفی

برای اینکه بتوانید برنامه جدید لاراول خود را شروع کنید، ما خوشحالیم که کیت های احراز هویت و شروع برنامه را ارائه می دهیم. این کیت‌ها به‌طور خودکار برنامه شما را با مسیرها، کنترل‌کننده‌ها و نماهایی که برای ثبت نام و احراز هویت کاربران برنامه‌تان نیاز دارید، قرار می‌دهند.

در حالی که می توانید از این کیت های شروع کننده استفاده کنید، اما نیازی به آنها نیست. شما آزاد هستید که به سادگی با نصب یک نسخه جدید از لاراول، اپلیکیشن خود را از ابتدا بسازید. در هر صورت، ما می دانیم که شما چیزی عالی خواهید ساخت!

لاراول بریز

Laravel Breeze یک پیاده‌سازی ساده و ساده از تمام ویژگی‌های احراز هویت لاراول ، از جمله ورود، ثبت نام، تنظیم مجدد رمز عبور، تأیید ایمیل و تأیید رمز عبور است. علاوه بر این، Breeze شامل یک صفحه "نمایه" ساده است که در آن کاربر می تواند نام، آدرس ایمیل و رمز عبور خود را به روز کند.

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

بوت کمپ لاراول

اگر به تازگی با لاراول آشنا شده اید، به راحتی وارد Bootcamp لاراول شوید . Laravel Bootcamp شما را در ساخت اولین برنامه Laravel با استفاده از Breeze راهنمایی می کند. این یک راه عالی برای بازدید از همه چیزهایی است که لاراول و بریز ارائه می دهند.

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

ابتدا باید یک برنامه جدید لاراول ایجاد کنید . اگر برنامه خود را با استفاده از نصب کننده لاراول ایجاد کنید ، از شما خواسته می شود که 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، باید دارایی های ظاهری برنامه خود را نیز کامپایل کنید:

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

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

برای کسب اطلاعات بیشتر در مورد کامپایل کردن CSS و جاوا اسکریپت برنامه خود، مستندات لاراول Vite را بررسی کنید .

بریز و لایو وایر

لاراول بریز داربست لایو وایر را نیز ارائه می دهد . Livewire یک راه قدرتمند برای ساختن رابط‌های کاربری پویا، واکنش‌گرا و جلویی فقط با استفاده از PHP است.

Livewire برای تیم هایی مناسب است که عمدتاً از قالب های Blade استفاده می کنند و به دنبال جایگزین ساده تری برای چارچوب های SPA مبتنی بر جاوا اسکریپت مانند Vue و React هستند.

برای استفاده از پشته Livewire، می توانید پشته Livewire frontend را هنگام اجرای breeze:install دستور Artisan انتخاب کنید. پس از نصب داربست Breeze، باید مهاجرت های پایگاه داده خود را اجرا کنید:

php artisan breeze:install
 
php artisan migrate

نسیم و واکنش / Vue

Laravel Breeze همچنین داربست های React و Vue را از طریق اجرای Inertia frontend ارائه می دهد. Inertia به شما امکان می دهد برنامه های React و Vue مدرن و تک صفحه ای را با استفاده از مسیریابی و کنترلرهای کلاسیک سمت سرور بسازید.

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

هنگام انتخاب پشته Vue یا React frontend، نصب کننده Breeze همچنین از شما می خواهد تعیین کنید که آیا مایل به پشتیبانی Inertia SSR یا TypeScript هستید یا خیر. پس از نصب داربست Breeze، باید دارایی های ظاهری برنامه خود را نیز کامپایل کنید:

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

Breeze و Next.js / API

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

php artisan breeze:install
 
php artisan migrate

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

پیاده سازی مرجع Next.js

در نهایت، شما آماده هستید که این بک اند را با فرانت اند مورد نظر خود جفت کنید. پیاده‌سازی مرجع بعدی Breeze frontend در GitHub در دسترس است . این فرانت اند توسط لاراول نگهداری می شود و دارای همان رابط کاربری مانند پشته های سنتی Blade و Inertia است که توسط Breeze ارائه شده است.

لاراول جت استریم

در حالی که Laravel Breeze یک نقطه شروع ساده و حداقلی برای ساخت یک برنامه لاراول ارائه می‌کند، Jetstream این عملکرد را با ویژگی‌های قوی‌تر و پشته‌های فن‌آوری frontend اضافی افزایش می‌دهد. برای کسانی که کاملاً با لاراول جدید هستند، توصیه می کنیم قبل از فارغ التحصیلی در لاراول جت استریم، طناب ها را با لاراول بریز یاد بگیرند.

Jetstream یک داربست برنامه با طراحی زیبا برای لاراول ارائه می دهد و شامل ورود، ثبت نام، تأیید ایمیل، احراز هویت دو مرحله ای، مدیریت جلسه، پشتیبانی API از طریق Laravel Sanctum و مدیریت تیم اختیاری است. Jetstream با استفاده از Tailwind CSS طراحی شده است و انتخاب شما از داربست های جلویی Livewire یا Inertia را ارائه می دهد.

اسناد کامل برای نصب لاراول جت استریم را می توان در اسناد رسمی جت استریم یافت .