phpstan extensions

Slam Phpstan Extensiones

Extensiones para Phpstan

Instalación

Para usar esta extensión, requiere en compositor:

composer require --dev slam/phpstan-extensions

Uso

Cuando esté utilizando phpstan/extension-installer , conf/slam-rules.neon se incluirá automáticamente.

De lo contrario, debe incluir conf/slam-rules.neon en su phpstan.neon :

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

Normas

1. SlamPhpStanUnusedVariableRule : verifique las funciones interiores variables nunca utilizadas después de la asignación inicial
2. SlamPhpStanMissingClosureParameterTypehintRule : requiere parámetros typeHints para cierres; ADVERTENCIA: No se permite PHPDOC, ver phpstan/phpstan-strict-rules#87
3. SlamPhpStanStringToClassRule : requiere cadenas que se refieran a las clases para expresarse con ::class
4. SlamPhpStanGotoRule : no goto permitido
5. SlamPhpStanClassNotationRule :
   1. Las interfaces deben terminar con "interfaz"
   2. Los rasgos deben terminar con "rasgo"
   3. Las clases abstractas deben comenzar con "abstracto"
   4. Las excepciones deben terminar con "excepción"
6. SlamPhpStanPhpUnitFqcnAnnotationRule : Las clases que se encuentran en las siguientes anotaciones de Phpunit deben existir:
   1. @expectedException
   2. @covers
   3. @coversDefaultClass
   4. @uses
7. SlamPhpStanAccessGlobalVariableWithinContextRule : inhibir el acceso a globales dentro de las clases que extienden o implementan una determinada clase/interfaz
8. SlamPhpStanAccessStaticPropertyWithinModelContextRule : inhibir el acceso a los atributos estáticos de una clase dentro de las clases que extienden o implementan una determinada clase/interfaz, útil para prohibir el uso de singletons en modelos

Now-Now Config

Una configuración not-now-rules.neon está presente para prohibir las llamadas al sistema de fecha sin procesar:

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

Estas reglas prohíben:

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

En su lugar, debe confiar en una abstracción de reloj como lcobucci/clock .

Advertencia: las reglas no son perfectas, un usuario puede engañarlas fácilmente; Solo están destinados a ayudar a la transición a una abstracción de reloj adecuada.

Configuración específica de Symfony

Una configuración symfony-rules.neon está presente para proyectos Symfony:

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

Con las siguientes configuraciones:

1. SlamPhpStanSymfonyFilesystemRule : prohíbe las llamadas a las funciones del sistema de archivos sin procesar bien envueltas por componente symfony/filesystem
2. SlamPhpStanSymfonyProcessRule : Prohibir las llamadas a las funciones del sistema sin procesar bien envueltas por componente symfony/process

Configuración específica de YII

Una configuración de yii-rules.neon está presente para proyectos yii:

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

Con las siguientes configuraciones:

1. SlamPhpStanAccessGlobalVariableWithinContextRule para negar el uso de $_GET , $_POST y otras variables globales en modelos que implementan yiidbActiveRecordInterface : acceder a singletons en modelos se considera una antigüedad
2. SlamPhpStanAccessStaticPropertyWithinModelContextRule para negar el uso de variables estáticas yiiBaseYii como $app en modelos que implementan yiidbActiveRecordInterface : acceder a singletons en modelos se considera una antiinteria