Test en PHP : aperçu des frameworks et outils (PHPUnit, Pest, Codeception)

Introduction aux tests d'applications PHP

Les tests sont une partie essentielle du développement professionnel en PHP. Ils permettent de détecter les erreurs dès les premières étapes, simplifient le refactoring et améliorent la stabilité du code. L'écosystème PHP dispose d'un ensemble d'outils puissants : du classique PHPUnit aux frameworks modernes comme Pest, en passant par des utilitaires spécialisés pour l'analyse de couverture et les tests de mutation.

Dans cet article, nous examinerons les frameworks et outils clés qui vous aideront à organiser des tests de qualité pour vos projets PHP.

PHPUnit — la base des tests

PHPUnit est la norme de facto pour les tests unitaires en PHP. Il prend en charge toutes les fonctionnalités modernes : assertions, fixtures (setUp/tearDown), data providers, tests d'exceptions, stubs et mocks.

Installation via Composer :

composer require --dev phpunit/phpunit

Exemple d'un test simple pour une classe de calculatrice :

<?phpuse PHPUnit\\Framework\\TestCase;

class CalculatorTest extends TestCase{    public function testAddition()    {        $calculator = new Calculator();        $this->assertEquals(4, $calculator->add(2, 2));    }

    /** @dataProvider additionProvider */    public function testWithDataProvider($a, $b, $expected)    {        $calculator = new Calculator();        $this->assertEquals($expected, $calculator->add($a, $b));    }

    public function additionProvider(): array    {        return [            [0, 0, 0],            [1, 1, 2],            [-1, 1, 0],        ];    }}

Fonctionnalités clés de PHPUnit :

• Assertions : assertEquals, assertTrue, assertCount, assertInstanceOf et des dizaines d'autres.
• Fixtures : méthodes setUp() et tearDown() pour préparer et nettoyer l'environnement.
• Data providers : annotation @dataProvider pour exécuter un même test avec différents ensembles de données.
• Tests d'exceptions : expectException() et expectExceptionMessage().
• Stubs et mocks : createMock() et getMockBuilder() pour isoler le code testé.

Pest — élégant et moderne

Pest est un framework de test construit au-dessus de PHPUnit, mais avec une syntaxe plus concise et expressive. Il s'inspire de Jest (JavaScript) et convient parfaitement aux projets où la lisibilité des tests est importante.

Installation :

composer require --dev pestphp/pest

Exemple du même test avec Pest :

<?php

use function Pest\\Faker\\fake;

test('addition works correctly', function () {    $calculator = new Calculator();    expect($calculator->add(2, 2))->toBe(4);});

dataset('numbers', [    [0, 0, 0],    [1, 1, 2],    [-1, 1, 0],]);

test('addition with data provider', function ($a, $b, $expected) {    $calculator = new Calculator();    expect($calculator->add($a, $b))->toBe($expected);})->with('numbers');

Avantages de Pest :

• Code minimal — pas besoin de créer des classes de test.
• Fonctions intégrées expect(), test(), it() pour une description en langage naturel.
• Enregistrement automatique des tests à partir de fonctions globales.
• Prise en charge des ensembles imbriqués (describe) et des tests architecturaux.

Codeception — pour les tests d'intégration et BDD

Codeception est un framework universel qui combine les tests unitaires, fonctionnels, d'intégration et d'acceptation. Il est particulièrement populaire pour tester les applications web (Laravel, Symfony, Yii) et les API.

Installation :

composer require --dev codeception/codeception

Exemple d'un test d'acceptation pour la connexion à un site :

<?php$I = new AcceptanceTester($scenario);$I->amO