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 Notation
4. SlamPhpStanGotoRule : no goto разрешено
5. SlamPhpStanClassNotationRule :
   1. Интерфейсы должны заканчиваться "интерфейсом"
   2. Черты должны закончиться "чертой"
   3. Абстрактные классы должны начинаться с "аннотация"
   4. Исключения должны закончиться «исключением»
6. SlamPhpStanPhpUnitFqcnAnnotationRule : классы, найденные в следующих аннотациях Phpunit, должны существовать:
   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 Config присутствует для Symfony Projects:

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

Со следующими конфигурациями:

1. SlamPhpStanSymfonyFilesystemRule : запрещайте вызовы для функций RAW symfony/filesystem хорошо завернуты
2. SlamPhpStanSymfonyProcessRule : запрещайте вызовы для необработанных системных функций, хорошо обернутых компонентом symfony/process

YII-специфическая конфигурация

Конфигурация yii-rules.neon присутствует для проектов YII:

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

Со следующими конфигурациями:

1. SlamPhpStanAccessGlobalVariableWithinContextRule отрицать использование $_GET , $_POST и других глобальных переменных в моделях, внедряющих yiidbActiveRecordInterface : Доступ к синглете в моделях считается анти-паттерном
2. SlamPhpStanAccessStaticPropertyWithinModelContextRule чтобы отрицать использование статических переменных yiiBaseYii таких как $app в моделях, внедряющих yiidbActiveRecordInterface : доступ к синглете в моделях считается анти-паттерном