phpstan extensions

SLAM PHPSTAN extensions

امتدادات ل phpstan

تثبيت

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

composer require --dev slam/phpstan-extensions

الاستخدام

عندما تستخدم phpstan/extension-installer ، سيتم تضمين conf/slam-rules.neon تلقائيًا.

وإلا فإنك تحتاج إلى تضمين conf/slam-rules.neon في phpstan.neon :

 includes :
    - vendor/slam/phpstan-extensions/conf/slam-rules.neon 

قواعد

1. SlamPhpStanUnusedVariableRule : تحقق من عدم استخدام وظائف داخلية متغيرة أبدًا بعد التخصيص الأولي
2. SlamPhpStanMissingClosureParameterTypehintRule : يتطلب المعلمة من النوعين للإغلاق ؛ تحذير: لا مسموح بالـ PHPDOC ، انظر phpstan/phpstan-strict-rules#87
3. SlamPhpStanStringToClassRule : يتطلب سلاسل تشير إلى الفصول التي سيتم التعبير عنها مع ::class
4. SlamPhpStanGotoRule : لا يسمح Goto
5. SlamPhpStanClassNotationRule :
   1. يجب أن تنتهي الواجهات بـ "واجهة"
   2. يجب أن تنتهي السمات بـ "سمة"
   3. يجب أن تبدأ الفصول التجريدية بـ "Abstract"
   4. يجب أن تنتهي الاستثناءات بـ "استثناء"
6. SlamPhpStanPhpUnitFqcnAnnotationRule : يجب أن توجد فئات موجودة في تعليقات التعليقات التوضيحية التالية:
   1. @expectedException
   2. @covers
   3. @coversDefaultClass
   4. @uses
7. SlamPhpStanAccessGlobalVariableWithinContextRule : تمنع الوصول إلى الكرات داخل الفئات التي تمتد أو تنفيذ فئة/واجهة معينة
8. SlamPhpStanAccessStaticPropertyWithinModelContextRule : تمنع الوصول إلى السمات الثابتة لفئة ما في فئات تمدد أو تنفيذ فئة/واجهة معينة ، مفيدة لحظر استخدام المفرد في النماذج

ليس التكوين لا شيء

not-now-rules.neon موجود.

 includes :
    - vendor/slam/phpstan-extensions/conf/not-now-rules.neon

هذه القواعد لا سمح:

1. new DateTimeImmutable()
2. new DateTime('yesterday')
3. date('Ym-d')
4. time()
5. strtotime('noon')

يجب عليك بدلاً من ذلك الاعتماد على تجريد على مدار الساعة مثل lcobucci/clock .

تحذير: القواعد ليست مثالية ، يمكن للمستخدم أن يخدعهم بسهولة ؛ تهدف فقط للمساعدة في الانتقال إلى تجريد مناسبة على مدار الساعة.

التكوين الخاص بـ Symfony

يوجد تكوين symfony-rules.neon .

 includes :
    - vendor/slam/phpstan-extensions/conf/symfony-rules.neon

مع التكوينات التالية:

1. SlamPhpStanSymfonyFilesystemRule : لا سمح للمكالمات إلى وظائف نظام الملفات الخام ملفوف جيدا بواسطة مكون symfony/filesystem
2. SlamPhpStanSymfonyProcessRule : لا سمح المكالمات إلى وظائف النظام الخام ملفوف جيدًا بواسطة مكون symfony/process

تكوين yii محدد

A yii-rules.neon config موجود لمشاريع yii:

 includes :
    - vendor/slam/phpstan-extensions/conf/yii-rules.neon

مع التكوينات التالية:

1. SlamPhpStanAccessGlobalVariableWithinContextRule لإنكار استخدام $_GET و yiidbActiveRecordInterface $_POST وغيرها
2. SlamPhpStanAccessStaticPropertyWithinModelContextRule لإنكار استخدام المتغيرات الثابتة yiiBaseYii مثل $app في النماذج التي تنفذ yiidbActiveRecordInterface : يعتبر الوصول إلى المفردات في النماذج مضادًا للانتقام