نسخه:

کیت های شروع

معرفی

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

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

لاراول بریز

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

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

Breeze نقطه شروع شگفت انگیزی برای شروع یک برنامه جدید Laravel است و همچنین یک انتخاب عالی برای پروژه هایی است که قصد دارند قالب های Blade خود را با Laravel Livewire به سطح بعدی برسانند .

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

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

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

ابتدا باید یک برنامه جدید لاراول ایجاد کنید ، پایگاه داده خود را پیکربندی کنید و مهاجرت های پایگاه داده خود را اجرا کنید . هنگامی که یک برنامه Laravel جدید ایجاد کردید، می توانید Laravel Breeze را با استفاده از Composer نصب کنید: 

composer require laravel/breeze --dev

هنگامی که Breeze نصب شد، می توانید برنامه خود را با استفاده از یکی از "پشته های" Breeze که در مستندات زیر بحث شده است، داربست کنید.

نسیم و تیغه

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

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

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

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

حالت تاریک

اگر می خواهید Breeze هنگام ساخت داربست جلوی برنامه شما، پشتیبانی از «حالت تاریک» را شامل شود، به سادگی --dark دستورالعمل را هنگام اجرای breeze:install دستور ارائه کنید: 

php artisan breeze:install --dark

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

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

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

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

php artisan breeze:install vue
 
# Or...
 
php artisan breeze:install react
 
php artisan migrate
npm install
npm run dev

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

رندر سمت سرور

اگر می‌خواهید Breeze از Inertia SSR پشتیبانی کند ، می‌توانید ssr هنگام فراخوانی breeze:install دستور، این گزینه را ارائه دهید: 

php artisan breeze:install vue --ssr
php artisan breeze:install react --ssr

Breeze & Next.js / API

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

php artisan breeze:install api
 
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 را ارائه می دهد.

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