دليل أسلوب ترميز PHP الحديث

تحدد معايير الترميز PSR-1 و PSR-2 كيف يجب أن تبدو الكود.

PSR-1 هو معيار التشفير الأساسي لـ PHP. PSR-2 هو دليل أسلوب الترميز.

قبل تعريفهم ، يمكن للمرء نسخ معيار ترميز من أحد الأطر الشائعة ، ولكن الآن بعد أن أصبح PHP معيارًا رسميًا للترميز ، يجب أن نهدف جميعًا إلى الالتزام به.

PSR-1 باختصار

  • يجب أن تعلن الملفات عن الرموز (الفئات ، الوظائف ، الثوابت ، إلخ) أو تسبب آثارًا جانبية (مثل إنشاء مخرجات ، وتغيير إعدادات .ini ، وما إلى ذلك) ولكن يجب ألا تفعل كلا الأمرين
  • يجب أن تتبع مساحات الأسماء والفئات PSR "التحميل التلقائي": [PSR-0 ، PSR-4]
  • يجب التصريح عن أسماء الفئات في StudlyCaps
  • يجب التصريح عن أسماء الطرق في حالة الجمل

PSR-2 باختصار

  • يجب أن يستخدم الرمز 4 مسافات للمسافات البادئة وليس علامات التبويب
  • يجب ألا يكون هناك حد صارم لطول الخط ؛ يجب أن يكون الحد المرن 120 حرفًا ؛ يجب أن تكون الأسطر 80 حرفًا أو أقل.
  • يجب أن يكون هناك سطر فارغ واحد بعد إعلان مساحة الاسم ، ويجب أن يكون هناك سطر فارغ واحد بعد إعلان كتلة الاستخدام.
  • يجب الإعلان عن الرؤية على جميع الخصائص والطرق ؛ يجب الإعلان عن الملخص والنهائي قبل الرؤية ؛ يجب التصريح عن الاستاتيكية بعد الرؤية.
  • يجب ألا تحتوي أقواس الفتح لهياكل التحكم على مسافة بعدها ، ويجب ألا تحتوي أقواس الإغلاق لهياكل التحكم على مسافة من قبل.

إنفاذ المعايير

من الضروري معرفة وفهم معايير الترميز. إن قيام IDE أو المحرر الخاص بك بفرضه تلقائيًا يعد خطوة كبيرة نحو الامتثال له.

على PHPStorm

إنه مدمج. انتقل إلى التفضيلات -> المحرر -> Code Style -> PHP ، انقر بزر الماوس الأيمن على "تعيين من .." واختر "النمط المحدد مسبقًا" -> "PSR1 / PSR2"

على نص سامية

يستخدمسامية- phpfmt