نسخه:

راهنمای مشارکت

گزارش های اشکال

برای تشویق همکاری فعال، لاراول به شدت درخواست های کشش را تشویق می کند، نه فقط گزارش های باگ. «گزارش‌های اشکال» ممکن است در قالب یک درخواست کشش حاوی یک آزمایش ناموفق نیز ارسال شود.

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

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

کد منبع لاراول در GitHub مدیریت می شود و برای هر یک از پروژه های لاراول مخازنی وجود دارد:

سوالات پشتیبانی

ردیاب‌های مشکل GitHub لاراول برای ارائه کمک یا پشتیبانی لاراول در نظر گرفته نشده است. در عوض، از یکی از کانال های زیر استفاده کنید:

بحث توسعه هسته

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

بحث غیررسمی در مورد اشکالات، ویژگی های جدید و پیاده سازی ویژگی های موجود در #internals کانال سرور Laravel Discord صورت می گیرد . تیلور اتول، نگهدارنده لاراول، معمولاً در روزهای هفته از ساعت 8 صبح تا 5 بعدازظهر (UTC-06:00 یا آمریکا/شیکاگو) در کانال حضور دارد و در زمان‌های دیگر به صورت پراکنده در کانال حضور دارد.

کدام شعبه؟

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

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

ویژگی‌های جدید اصلی باید همیشه به شعبه ارسال شود master که حاوی نسخه‌های آینده است.

اگر مطمئن نیستید که ویژگی شما واجد شرایط اصلی یا فرعی است، لطفاً از تیلور اتول در #internals کانال سرور Laravel Discord بپرسید .

دارایی های تدوین شده

اگر تغییری را ارسال می کنید که روی یک فایل کامپایل شده تأثیر می گذارد، مانند اکثر فایل های موجود در resources/sass مخزن resources/js ، laravel/laravel فایل های کامپایل شده را commit نکنید. به دلیل اندازه بزرگ، آنها را نمی توان به طور واقعی توسط یک نگهدار بررسی کرد. این می تواند به عنوان راهی برای تزریق کد مخرب به لاراول مورد سوء استفاده قرار گیرد. به منظور جلوگیری از این امر، تمامی فایل های کامپایل شده توسط نگهبانان لاراول تولید و متعهد خواهند شد.

آسیب پذیری های امنیتی

اگر آسیب‌پذیری امنیتی در لاراول کشف کردید، لطفاً یک ایمیل به Taylor Otwell ارسال کنید taylor@laravel.com . تمام آسیب پذیری های امنیتی به سرعت برطرف خواهد شد.

سبک کدنویسی

لاراول از استاندارد کدگذاری PSR-2 و استاندارد بارگذاری خودکار PSR-4 پیروی می کند .

PHPDoc

در زیر نمونه ای از بلوک اسناد لاراول معتبر آورده شده است. توجه داشته باشید که @param صفت با دو فاصله دنبال می شود، نوع آرگومان، دو فاصله دیگر و در نهایت نام متغیر: 

/**
 * Register a binding with the container.
 *
 * @param  string|array  $abstract
 * @param  \Closure|string|null  $concrete
 * @param  bool  $shared
 * @return void
 *
 * @throws \Exception
 */
public function bind($abstract, $concrete = null, $shared = false)
{
    //
}

StyleCI

اگر استایل کد شما کامل نیست نگران نباشید! StyleCI پس از ادغام درخواست‌های کششی، به‌طور خودکار هرگونه اصلاح سبک را در مخزن لاراول ادغام می‌کند. این به ما اجازه می دهد تا بر محتوای مشارکت تمرکز کنیم و نه سبک کد.

کد رفتار

کد رفتار لاراول از کد رفتاری روبی گرفته شده است. هرگونه نقض قوانین رفتاری ممکن است به Taylor Otwell گزارش شود ( taylor@laravel.com ):

  • شرکت کنندگان در برابر نظرات مخالف مدارا خواهند کرد.
  • شرکت کنندگان باید اطمینان حاصل کنند که زبان و اعمال آنها عاری از حملات شخصی و اظهارات شخصی توهین آمیز باشد.
  • هنگام تفسیر گفتار و اعمال دیگران، شرکت کنندگان باید همیشه نیت خوبی داشته باشند.
  • رفتاری که به طور منطقی بتوان آن را آزار و اذیت تلقی کرد، قابل تحمل نخواهد بود.