★★★

رابطة الحِزم الخارقة عبارة عن مجموعة من المُطوّرين الذين اجتمعوا معًا لبناء حِزم PHP متينة ومُختبرة وباستخدام معايير التطوير العصرية

★★★

حزمنا

* حِزم قيد التطوير

تعريفنا للجودة

اطلب من 100 مُطور أن يحصروا الميزات الواجب توفرها في الحزم البرمجية عالية الجودة وستحصل على أجوبة مُختلفة. وبحكم أن الوصول إلى إجابة مثالية لهذا السؤال قد يتطلب وقتًا طويلا وقد يكون مُملا أيضا، فإننا ارتأينا أن نجمع جُملة من القواعد التي نعتقد أنها تجعل من الحُزمة رائعة :
  1. تستخدم League كفضاء أسماء لمعيار PSR-4. وتضع كامل الشفرة المصدرية داخل مُجلد src؛

  2. تمتثل لمعيار PSR-2 في كامل شفراتها البرمجية؛

  3. مُدرجة على Packagist وتستخدم league كفضاء اسم المُوزّع؛

  4. تحتوي على اختبار وحدات، حيث نهدف إلى أن تكون الحُزمات مُختبرة بنسبة تتجاوز 80%؛

  5. تُوثّق جميع نواحي الشفرة البرمجية باستخدام DocBlock؛

  6. تعتمد على مبدأ الإدارة الدلالية لنُسخ البرمجيات لإدارة التحديثات؛

  7. تحتفظ بسجل للتغييرات؛

  8. تستخدم Travis-CI للتحقّق الآلي من معايير كتابة الشفرات البرمجية ولإجراء الإختبارات؛

  9. تحتوي على ملف README مُفصّل؛

  10. تستبعد الملفات الاختيارية باستخدام ملف .gitattributes

لماذا؟

بدل أن ننشر حِزمنا على حساباتنا الخاصة فإننا ننشرها هنا لأسباب عديدة قد يكون أهمها :

تشاركنا في حل مُشكل مُعين هو نصف الطريق لإيجاد حل له

عندما نكون مُجتمعين فإننا نعمل بشكل أسرع وأكثر كفاءة، سنحصل على مُلاحظات أكثر، وسنكون قادرين على تصحيح كل الخُطوب ومُعالجة كافة طلبات السحب بشكل أسرع.

لا نهدف إلى إعادة اختراع العجلة من جديد ما لم تكن هذه العجلة بالية وغير صالحة للاستخدام البشري. إذا لم يكن بالإمكان تنصيب الشفرة باستخدام Composer، أو أنها مكتوبة من دون احترام أي من أنماط كتابة الشفرات البرمجية المعروفة، أو أنها لا تحتوي أي اختبارات وحدات، تحتوي أخطاء وعللا برمجية، أو أن مُطورها قد تخلى عنها، فإنه من المُحتمل جدا أن أفضل طريقة لجعل هذه الحزمة أفضل هو إعادة كتابتها من جديد. نهدف إلى توفير أفضل نُسخة مُمكنة من هذه المكتبات