wp stubs

وورد كوبس

يحتوي هذا الريبو على كعب WordPress الذي تم إنشاؤه تلقائيًا لاستخدامه مع أدوات التحليل الثابت.

التعليمات

• لماذا هذا بدلاً من "<إدراج مشروع الخروج هنا>"؟

الغرض من هذا المشروع هو:

• وجود إصدارات متعددة من WP في نفس الفرع/الإصدار
• عدم وجود كوب من الكرات ، ولكن امتلاك كعب للثوابت
• وجود طريقة "تجاوز" باسكال. من خلال إعلان الرعب في ملف fixtures.php . وبهذه الطريقة ، من السهل إصلاح docblocks غير الصحيحة في WordPress واستخدام كتلة DOC "المتقدمة" التي تدعمها محللون ثابتون (فكر في شكل الصفيف ، والاسم المستعار نوع ، وأنواع الإرجاع الشرطي ...)

كيف يعمل هذا

كل يوم ، يقوم سير العمل بإجراءات GitHub باستدعاء WP.org API للعثور على إصدارات WordPress جديدة.

إذا وجدت إصدارات جديدة ، فإنها تقوم بإنشاء وحفظ كعبها (باستخدام https://github.com/php-stubs/generator) أثناء تحديث كعب "أحدث".

كيفية استخدام

الاستخدام الأساسي هو لأدوات التحليل الثابت ، على سبيل المثال ، المزمور:

الطريقة 1: الحصول على جميع إصدارات WordPress

خطوات:

1. اطلب من هذا المشروع ( inpsyde/wp-stubs ) في خاصية ملحنك "require-dev"
2. قم بإنشاء ملف تكوين psalm.xml (انظر المستندات)
3. في تكوين المزمور ، أضف هذه الخطوط:

   < stubs >
       < file name = " vendor/inpsyde/wp-stubs/stubs/latest.php " />
   </ stubs >

يمكنك استبدال latest.php بإصدار WP محدد. انظر الإصدارات المتاحة في دليل /stubs .

ملاحظة : في هذا المجلد ، لا يعني رقم الإصدار المكون من رقمين مثل 5.9 بالضرورة إصدار WordPress 5.9 ، ولكن الأحدث في سلسلة 5.9.* . لذلك إذا كنت تستخدم الملحن لتتطلب WordPress ولديك متطلبات مثل 5.9.* ، فإن ملف كعب stubs/5.9.php سوف يتطابق مع الإصدار المثبت حاليًا.

يحتوي مجلد "كوبس" على كعب من الإصدارات العديدة بحيث يمكنك الاختيار ، ولكن سيكون من الممكن أيضًا الحصول على نص CI يقوم بتحميل الإصدارات المختلفة للاختبار مقابل كعب مختلف.

ومع ذلك ، قد يصبح حجم الحزمة ضخمًا ، وإذا لم يتم استبعاده من تحليل IDE ، فقد يؤثر على أداء IDE.

الطريقة 2: الحصول على نسخة محددة

المتطلبات المسبقة:

في composer.json الخاص بك json ، أعلن عن مستودع مثل هذا:

{
  "repositories" : [
    {
      "type" : " composer " ,
      "url" : " https://raw.githubusercontent.com/inpsyde/wp-stubs/main " ,
      "only" : [
        " inpsyde/wp-stubs-versions "
      ]
    }
  ]
}

ملاحظة لمطوري INPSYDE : تعكس منظمة INPSYDE في عازف الحزم الخاص المستودع المذكور أعلاه ، لذلك بالنسبة لمستودعات Inpsyde الخاصة ، من المحتمل ألا تكون هناك حاجة على الأرجح بالنظر إلى أن عازف الحزم الخاص قد تمت إضافته بالفعل إلى composer.json repo.json.

خطوات:

1. طلب مشروع "الإصدار" في خاصية "require-dev" { "require": { "inpsyde/wp-stubs-versions": "dev-latest" } } . (لاحظ كيف تم -versions اسم الحزمة)
2. قم بإنشاء ملف تكوين psalm.xml (انظر المستندات)
3. في تكوين المزمور ، أضف هذه الخطوط:

   < stubs >
       < file name = " vendor/inpsyde/wp-stubs-versions/latest.php " />
   </ stubs >

باستخدام هذا النهج ، سيكون الإصدار الأخير هو التنزيلات الوحيدة للملحن.

الحد الأدنى من المتطلبات

يتطلب الكود الذي يولد كوبان PHP 8.0+. ومع ذلك ، عند استهلاك الحزمة ، لا توجد متطلبات أدنى إلى جانب القدرة على تشغيل WordPress.

رخصة

هذا المستودع هو برنامج مجاني ، ويتم إصداره بموجب شروط ترخيص معهد ماساتشوستس للتكنولوجيا. انظر الترخيص للحصول على ترخيص كامل.