Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Symfony : PHPUnit, PHPStan/Psalm et Rector

Chez Symfony, les tests commencent avec PHPUnit tout court. Un paquet de liaison lisse ce qui tient au framework : dĂ©marrer le noyau, lui envoyer des requĂȘtes, interroger Doctrine depuis un test.

composer require symfony/test-pack --dev
class OrderControllerTest extends WebTestCase
{
    public function testSubmittingAnEmptyOrderFails(): void
    {
        $client = static::createClient();
        $client->request('POST', '/orders/1/submit');

        $this->assertResponseStatusCodeSame(422);
    }
}
php bin/phpunit

PHPStan, ou son proche cousin Psalm, analyse le code sans le lancer. Il attrape les erreurs de type, le code inatteignable et les appels Ă  des mĂ©thodes qui n’existent pas, avant qu’ils ne deviennent des bugs Ă  l’exĂ©cution. Les deux fonctionnent aussi hors de Symfony, sur les composants autonomes vus plus haut dans ce livre.

composer require phpstan/phpstan --dev
vendor/bin/phpstan analyse src --level=8

Rector automatise les montĂ©es de version et les refactorisations. Donnez-lui une version cible de PHP ou de Symfony et il réécrit votre syntaxe pour s’y conformer, mĂ©caniquement, sur des milliers de fichiers d’un coup.

composer require rector/rector --dev
// rector.php
return RectorConfig::configure()
    ->withPaths([__DIR__ . '/src'])
    ->withSets([SymfonySetList::SYMFONY_64]);
vendor/bin/rector process

Quand le choisir

Tout projet Symfony, quelle que soit sa taille. Rector gagne sa place le jour oĂč une montĂ©e de version majeure de Symfony ou de PHP se profile et oĂč retoucher chaque fichier concernĂ© Ă  la main cesse d’ĂȘtre rĂ©aliste.

Quand ce n’est pas le bon outil

Rector sur une base de code sans aucun test. Ses modifications sont mĂ©caniques, mais quelque chose doit vĂ©rifier qu’elles n’ont pas changĂ© le comportement. Associez-le au moins aux tests ci-dessus.

Sous le capot : Rector transforme votre code en AST (arbre de syntaxe abstraite), la structure que le moteur de PHP construit lui-mĂȘme avant l’exĂ©cution, lui applique une rĂšgle, puis rĂ©imprime du PHP modifiĂ©. C’est une transformation mĂ©canique du code, pas un modĂšle de langage qui devine une intention.