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

• گزارش های اشکال
• بحث توسعه هسته
• کدام شعبه؟
• آسیب پذیری های امنیتی
• سبک کدنویسی

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

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

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

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

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

• فریم ورک لاراول
• اپلیکیشن لاراول
• مستندات لاراول
• صندوقدار لاراول
• فرستاده لاراول
• خانه لاراول
• اسکریپت های ساخت لاراول Homestead
• وب سایت لاراول
• هنر لاراول

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

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

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

کدام شعبه؟

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

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

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

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

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

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

سبک کدنویسی

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

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