الصفحة الرئيسية>كود المصدر JSP>فئات أخرى
تنزيل

مهم

أهلا بالجميع! هذا هو viktor الذي يدير هذا الامتداد phpstan. أخطط للتوقف عن المساهمة في نظام WordPress البيئي لأنه صعب للغاية ولا أحد يطلب مني الانضمام إلى فريقه لأنني مفكر ، شخص DevOps ، صانع أدوات (وليس منشئًا).

يرجى دعم عملي لتجنب التخلي عن هذه الحزمة.

شكرًا لك!

امتدادات WordPress ل phpstan

تحليل ثابت للنظام الإيكولوجي لورد.

  • phpstan
  • وورد

سمات

  • تمكن Phpstan من تحليل الإضافات والموضوعات WordPress.
  • يقوم بتحميل حزمة php-stubs/wordpress-stubs .
  • يوفر امتدادات نوع الإرجاع الديناميكي للوظائف التي لا يتم تغطيتها في php-stubs/wordpress-stubs
  • يحدد بعض الثوابت الأساسية WordPress.
  • يتحقق من صحة docblocks الاختيارية قبل apply_filters() و do_action() ، معالجة نوع @param الأول على أنه نهائي.

متطلبات

  • Phpstan 2.0 أو أعلى
  • PHP 7.4 أو أعلى (تم اختباره حتى PHP 8.3)

تثبيت

لاستخدام هذا الامتداد ، اطلبه في الملحن: 

composer require --dev szepeviktor/phpstan-wordpress

إذا قمت أيضًا بتثبيت Phpstan/Extension-instholer ، فأنت جميعًا قد تم تعيينه!

التثبيت اليدوي

إذا كنت لا ترغب في استخدام phpstan/extension-installer ، قم بتضمين extension.neon في تكوين Phpstan لمشروعك: 

 includes :
    - vendor/szepeviktor/phpstan-wordpress/extension.neon

إعدادات

لا يلزم إعداد إضافي. ؟ ما عليك سوى تكوين phpstan - على سبيل المثال - كما هو موضح أدناه: 

 parameters :
    level : 5
    paths :
        - plugin.php
        - inc/

لمزيد من التفاصيل ، تفضل بزيارة مرجع Phpstan Config.

استخدم Autoloader الملحن أو Autoloader مخصص!

الاستخدام

قم بإجراء التحليل بـ: 

vendor/bin/phpstan analyze

ثم إصلاح خطأ و GOTO 10 !

يمكنك العثور على مزيد من المعلومات في دليل examples ، على سبيل المثال examples/phpstan.neon.dist

الاستخدام في WooCommerce Webshops

الرجوع إلى Stubs WooCommerce للحصول على إرشادات محددة.

استخدام docblock apply_filters()

غالبًا ما يستخدم النظام البيئي لـ WordPress docblocks phpdoc بطريقة غير قياسية لتوثيق المعلمات التي تم تمريرها لتطبيق apply_filters() . هذا مثال: 

 /**
 * Filters the page title when creating an HTML drop-down list of pages.
 *
 * @param string  $title Page title.
 * @param WP_Post $page  Page data object.
 */
$ title = apply_filters ( ' list_pages ' , $ title , $ page );

يقرأ هذا الملحق هذه docblocks ويترشد phpstan لعلاج نوع إرجاع المرشح كما هو مؤكد ، استنادًا إلى علامة @param الأولى. في هذا المثال ، يفسر Phpstan $title string .

للحصول على أفضل النتائج ، تأكد من أن علامة @param الأولى في هذه docblocks دقيقة.

اجعل الكود الخاص بك قابل للاختبار

  • اكتب رمز OOP CLEAN: 1 فئة لكل ملف ، ولا يوجد رمز إضافي خارج class Name { ... } .
  • استخدم تسمية فئة متسقة (WPCs أو PSR-4) ودروس المتجر في inc/ دليل مخصص.
  • أضف كتل PHPDOC دقيقة إلى الفئات والخصائص والأساليب والوظائف ومكالمات apply_filters() .
  • اختر أجزاء ملف البرنامج المساعد الرئيسي.
  • تجنب استخدام الثوابت الأساسية ، استخدم الوظائف الأساسية.
  • تجنب ممارسات PHP السيئة ، مثل:
    • الوظائف: eval ، extract ، compact ، list
    • اكتب شعوذة: $a = '15'; if ($a) ...
  • إذا كنت if إلى رمز قوي ، فحاول تجنب جميع أنواع التوفيق بين النوع
  • تجنب تمكين exit_error في WP_CLI::launch أو WP_CLI::runcommand لتحسين قابلية الاختبار.

الزاوية القذرة (الأسئلة الشائعة)

يستخدم WordPress الوظيفة الشرطية وتعريف الفئة للسماح بالتجاوز. استخدم أمر sed لاستبعاد استئصال الوظائف عند تعريفها مسبقًا. 

sed -i -e ' s#function is_gd_image#function __is_gd_image# ' vendor/php-stubs/wordpress-stubs/wordpress-stubs.php
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل