شروع کار با لاراول – پکیج‌های شروع

با ادامه ترجمه مستندات فارسی Laravel 10  بخش (شروع کار با لاراول – پکیج‌های شروع)، در خدمت شما کاربران گرامی وب‌سایت آموزشی لاراول کارا هستیم. امیدواریم که این مطلب برای شما مفید واقع شده باشد. در صورت داشتن هرگونه سوال یا ابهام، لطفاً در قسمت نظرات با ما در ارتباط باشید.

استات کیت چیست؟

Starter kits یا پکیج‌های شروع، مجموعه‌ای از ابزارها، کتابخانه‌ها، قالب‌ها و منابع دیگر هستند که برای شروع یک پروژه با فریم‌ورک مشخصی طراحی شده‌اند. این پکیج‌ها معمولاً شامل مولفه‌هایی هستند که برای برنامه‌نویسان می‌تواند مفید باشد، مانند قالب‌های آماده، فرم‌ها و بخش‌های امنیتی.

استفاده از Starter kits به شما این اجازه را می‌دهد که با شروع سریع به کار، زمان و هزینه‌ی بیشتری را در توسعه‌ی نرم‌افزار خود صرفه‌جویی کنید. همچنین، این پکیج‌ها می‌توانند به شما کمک کنند تا بهترین شیوه‌های برنامه‌نویسی را در یک فریم‌ورک خاص به کار ببرید. در Laravel، Starter kits به شما این اجازه را می‌دهند که بدون نیاز به ایجاد همه چیز از صفر، با یک پروژه‌ی Laravel جدید شروع کنید.

Starter kits یا پکیج‌های شروع برای فریم‌ورک Laravel، مجموعه‌ای از ابزارها، کتابخانه‌ها، قالب‌ها و منابع دیگر هستند که به شما کمک می‌کنند تا بدون نیاز به ایجاد همه چیز از صفر، با یک پروژه‌ی Laravel جدید شروع کنید.

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

# معرفی (Introduction)

برای کمک به شروع سریع‌تر در ساخت برنامه‌های جدید با فریم‌ورک Laravel، ما Starter kits و Authentication starter kits را ارائه می‌دهیم. این پکیج‌ها به طور خودکار برای شما برنامه‌ی مورد نظرتان را با روت‌ها، کنترلرها و نمایش‌های لازم برای عضویت و احراز هویت کاربران برنامه‌ی، ساخته می‌شوند.

استفاده از Starter kits به شما کمک می‌کند تا سریع‌تر شروع به کار کنید، اما استفاده از آنها اجباری نیست. شما می‌توانید برنامه‌ی خود را از صفر شروع کنید و با نصب Laravel، برنامه‌ی خود را ایجاد کنید. در هر صورت، ما مطمئنیم که شما قادر خواهید بود یک برنامه‌ی عالی بسازید!

# Laravel Breeze

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

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

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

# Installation

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

composer require laravel/breeze --dev

بعد از نصب Breeze، شما می‌توانید با استفاده از یکی از “stack”های Breeze که در ادامه مستندات بحث شده است، برنامه‌ی خود را ایجاد کنید.

# Breeze & Blade

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

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

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

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

Dark Mode یا حالت تاریک
اگر می‌خواهید Breeze پشتیبانی از “حالت تاریک” را در زمان ساختاردهی واسط کاربری برنامه‌ی خود شامل کند، به راحتی می‌توانید هنگام اجرای دستور breeze:install، دستور –dark را بدهید.

php artisan breeze:install --dark

# Breeze & React / Vue

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

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

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 تعریف شده‌اند.

Server-Side Rendering (SSR):
Server-Side Rendering (SSR) یک تکنیک برای رندر کردن صفحات وب بر روی سرور است که پیش از ارسال به مرورگر وب کاربر، انجام می‌شود. این می‌تواند باعث افزایش سرعت بارگیری اولیه صفحات وب و بهبود بهینه‌سازی موتورهای جستجو شود.

در زمینه Laravel Breeze، با استفاده از ابزارهایی مانند Nuxt.js یا Vue Server Renderer، پشتیبانی از SSR می‌تواند به Inertia stack اضافه شود. برای ایجاد پشتیبانی از Inertia SSR با Laravel Breeze، می‌توانید گزینه ssr را هنگام اجرای دستور breeze:install ارائه دهید.

لطفا توجه داشته باشید که اضافه کردن پشتیبانی از SSR می‌تواند پیچیدگی برنامه شما را افزایش دهد و نیاز به راه‌اندازی و پیکربندی اضافی داشته باشد.

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

TypeScript:

هنگام استفاده از stack Vue یا React، می‌توانید با استفاده از گزینه –typescript، ساختاردهی را ایجاد کنید که شامل پشتیبانی از TypeScript باشد.

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

# Breeze & Next.js / API

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

php artisan breeze:install api
 
php artisan migrate

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

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

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

# Laravel Jetstream

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

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