عن المشروع

PHP: The Right Way هو مرجع سريع سهل القراءة لأفضل ممارسات PHP، ومعايير الترميز المقبولة، وروابط للدروس الشاملة عبر الويب. يوضح المشروع دافعه بوضوح: لقد افتقر مجتمع PHP إلى معلومات كافية وموثوقة للمبرمجين الجدد في PHP، ويهدف هذا الموقع إلى سد هذه الفجوة. هيكل الموقع والمستودع: - الموقع هو مشروع Jekyll مستضاف على GitHub Pages. - كل قسم وقسم فرعي هو ملف Markdown في _posts/، مع تحديد الأقسام الفرعية بـ isChild: true في بياناتها الأمامية (front matter). - يتم توليد التنقل وهيكل الصفحة تلقائيًا من هذه الملفات. معايير المحتوى: يجب أن تلتزم عينات الكود المقدمة من المساهمين بمعايير PSR-1 أو أعلى. يتطلب دليل نمط المساهمين استخدام الإملاء الأمريكي (في المستودع الإنجليزي الرئيسي فقط)، والمسافة البادائية بأربعة مسافات بدلاً من علامات التبويب، وتغليف النص إلى 120 حرفًا. المساهمة: يقرأ المساهمون ملف CONTRIBUTING.md للحصول على تعليمات مفصلة، ثم يقومون بتفرع (fork) المستودع وتعديله، ويمكنهم اختيارياً تثبيت Ruby مع Jekyll gem لمعاينة التغييرات محليًا، وإرسال طلب سحب (pull request). يوفر المشروع أيضًا صور أعلام الويب التي يمكن للمؤيدين وضعها على مواقعهم الخاصة لتوجيه مطوري PHP الجدد إلى هذا المورد. الترجمات: الوثيقة متوفرة بلغات عديدة غير الإنجليزية، بما في ذلك الإسبانية، والفرنسية، والإندونيسية، والإيطالية، والبولندية، والبرتغالية البرازيلية، والرومانية، والسلوفينية، والصربية، والتركية، والبلغارية، والروسية، والأوكرانية، والعربية، والفارسية، والتايلاندية، والكورية، واليابانية، والصينية المبسطة، والصينية التقليدية. يتم إنتاج الترجمات الجديدة عن طريق تفرع المستودع ونشر النسخة المترجمة على GitHub Pages، إما كـ [username].github.io/php-the-right-way أو كنطاق فرعي مُهيأ عبر ملف CNAME؛ ثم يربط المشرفون بالترجمة المكتملة من الوثيقة الرئيسية لتجنب التجزئة. التأليف والترخيص: يدير المشروع Josh Lockhart، مؤلف إطار عمل Slim، مع المتعاونين Kris Jordan و Phil Sturgeon. يتم نشر المحتوى بموجب ترخيص Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported.