نسخه:

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

معرفی

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

برای تشویق همکاری فعال، لاراول در حال حاضر فقط درخواست‌های کشش را می‌پذیرد، نه گزارش‌های باگ. «گزارش‌های اشکال» ممکن است در قالب یک درخواست کشش حاوی یک تست واحد ناموفق ارسال شود. از طرف دیگر، نمایشی از اشکال در یک برنامه کاربردی لاراول ممکن است به عنوان یک درخواست کشش به مخزن اصلی لاراول ارسال شود . یک آزمون واحد یا برنامه سندباکس شکست خورده "اثبات" را برای تیم توسعه ارائه می دهد که اشکال وجود دارد، و پس از اینکه تیم توسعه باگ را برطرف کرد، به عنوان یک شاخص قابل اعتماد برای ثابت ماندن باگ عمل می کند.

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

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

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

کانال #laravel-dev IRC برای همه باز است. از همه خوش آمدید که برای شرکت یا صرفاً مشاهده بحث ها به کانال بپیوندید!

ویژگی های جدید

قبل از ارسال درخواست‌های کشش برای ویژگی‌های جدید، لطفاً از طریق #laravel-dev کانال IRC (Freenode) با تیلور اتول تماس بگیرید. اگر مشخص شد که این ویژگی برای چارچوب مناسب است، می توانید یک درخواست کشش ارائه دهید. اگر ویژگی رد شد، تسلیم نشوید! شما همچنان آزاد هستید که ویژگی خود را به بسته ای تبدیل کنید که می تواند از طریق Packagist در جهان منتشر شود .

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

اشکالات

از طریق تست واحد

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

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

اگر مطمئن نیستید که چگونه یک آزمون واحد شکست خورده را برای یک باگ بنویسید، سایر تست‌های واحد موجود در چارچوب را بررسی کنید. اگر هنوز گم شده اید، می توانید از کانال IRC (Freenode) کمک بخواهید #laravel .

کدام شعبه؟

توجه: این بخش در درجه اول برای کسانی اعمال می شود که درخواست های کششی را به مخزن لاراول/فریم ورک ارسال می کنند ، نه برنامه های Liferaft.

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

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

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

اگر مطمئن نیستید که ویژگی شما واجد شرایط اصلی یا فرعی است، لطفاً از تیلور اتول در #laravel-dev کانال IRC (Freenode) بپرسید.

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

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

سبک کدنویسی

لاراول از استانداردهای کدگذاری PSR-0 و PSR-1 پیروی می کند . علاوه بر این استانداردها، استانداردهای کدگذاری زیر نیز باید رعایت شود:

  • اعلان فضای نام کلاس باید در همان خط باشد <?php .
  • باز شدن یک کلاس { باید در همان خط با نام کلاس باشد.
  • عملکردها و ساختارهای کنترلی باید از بریس های سبک آلمن استفاده کنند.
  • تورفتگی با برگه ها، تراز کردن با فاصله ها.