phpstan extensions

Extensões de phpstan slam

Extensões para o Phpstan

Instalação

Para usar esta extensão, requer no compositor:

composer require --dev slam/phpstan-extensions

Uso

Quando você estiver usando phpstan/extension-installer , conf/slam-rules.neon será incluído automaticamente.

Caso contrário, você precisará incluir conf/slam-rules.neon em seu phpstan.neon :

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

Regras

1. SlamPhpStanUnusedVariableRule : Verifique as funções internas variáveis ​​nunca usadas após a atribuição inicial
2. SlamPhpStanMissingClosureParameterTypehintRule : Requer TypeHints de parâmetro para fechamentos; AVISO: Não é permitido PHPDOC, consulte phpstan/phpstan-strict-rules#87
3. SlamPhpStanStringToClassRule : requer strings que se referem às classes a serem expressas com ::class
4. SlamPhpStanGotoRule : Não é permitido Goto permitido
5. SlamPhpStanClassNotationRule :
   1. Interfaces devem terminar com "interface"
   2. Características devem terminar com "traço"
   3. Classes abstratas devem começar com "abstrato"
   4. Exceções devem terminar com "exceção"
6. SlamPhpStanPhpUnitFqcnAnnotationRule : as classes encontradas nas seguintes anotações da phpunit devem existir:
   1. @expectedException
   2. @covers
   3. @coversDefaultClass
   4. @uses
7. SlamPhpStanAccessGlobalVariableWithinContextRule : Inibe o acesso a globais nas classes que estendem ou implementam uma determinada classe/interface
8. SlamPhpStanAccessStaticPropertyWithinModelContextRule : Inibe o acesso a atributos estáticos de uma classe dentro de classes que estendem ou implementam uma determinada classe/interface, útil para proibir o uso de singletens em modelos

Não agora configuração

Uma configuração not-now-rules.neon está presente para proibir as chamadas do sistema de data bruta:

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

Essas regras proíbem:

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

Em vez disso, você deve confiar em uma abstração do relógio como lcobucci/clock .

Aviso: as regras não são perfeitas, um usuário pode enganá -las facilmente; Eles são destinados apenas a ajudar a transição para uma abstração adequada do relógio.

Configuração específica da Symfony

Uma configuração symfony-rules.neon está presente para projetos de Symfony:

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

Com as seguintes configurações:

1. SlamPhpStanSymfonyFilesystemRule : Proibir chamadas para funções de sistema de symfony/filesystem cru
2. SlamPhpStanSymfonyProcessRule : Proibir chamadas para funções de sistema bruto bem embrulhadas pelo componente symfony/process

Config específica de Yii

Uma configuração yii-rules.neon está presente para os projetos YII:

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

Com as seguintes configurações:

1. SlamPhpStanAccessGlobalVariableWithinContextRule para negar o uso de $_GET , $_POST e outras variáveis ​​globais em modelos que implementam yiidbActiveRecordInterface : O acesso a singletons em modelos é considerado um anti-Pattern
2. SlamPhpStanAccessStaticPropertyWithinModelContextRule para negar o uso de variáveis ​​estáticas yiiBaseYii como $app em modelos que implementam yiidbActiveRecordInterface : Acesso a singletons em modelos é considerado um anti-padrão