Tests unitaires et TDD en POO

Voici un exemple concret de test unitaire en PHP utilisant le framework PHPUnit. Imaginons que nous avons une classe Calculatrice avec une méthode additionner() que nous voulons tester :

<?php

// Inclusion du fichier à tester
require_once 'Calculatrice.php';

// Inclusion du framework PHPUnit
require_once 'vendor/autoload.php';

use PHPUnit\Framework\TestCase;

class CalculatriceTest extends TestCase
{
    // Méthode de test pour la méthode additionner()
    public function testAdditionner()
    {
        // Création d'une instance de la classe à tester
        $calculatrice = new Calculatrice();

        // Appel de la méthode à tester avec des valeurs d'entrée connues
        $resultat = $calculatrice->additionner(2, 3);

        // Assertion pour vérifier si le résultat est celui attendu
        $this->assertEquals(5, $resultat);
    }
}
Copy

Et voici le contenu de la classe Calculatrice que nous testons :

<?php

class Calculatrice
{
    // Méthode pour effectuer une addition
    public function additionner($a, $b)
    {
        return $a + $b;
    }
}
Copy

Dans cet exemple, nous avons créé une classe de test CalculatriceTest qui hérite de TestCase de PHPUnit. Nous avons défini une méthode de test testAdditionner() qui crée une instance de Calculatrice, appelle sa méthode additionner() avec deux valeurs d'entrée connues (2 et 3), puis utilise une assertion pour vérifier si le résultat retourné est égal à 5.

Vous pouvez ici voir un exemple de ce que donne l'utilisation de assertEqual.
Vous trouverez ici la documentation sur PHPUnit

Pour exécuter ce test, vous pouvez utiliser la ligne de commande PHPUnit ou votre environnement de développement intégré (IDE) qui prend en charge PHPUnit. Une fois que vous exécutez les tests, vous devriez voir une sortie indiquant si le test a réussi ou échoué.

<?php

// Inclusion du fichier à tester
require_once 'Calculatrice.php';

class CalculatriceTest
{
    // Méthode de test pour la méthode additionner()
    public function testAdditionner()
    {
        // Création d'une instance de la classe à tester
        $calculatrice = new Calculatrice();

        // Appel de la méthode à tester avec des valeurs d'entrée connues
        $resultat = $calculatrice->additionner(2, 3);

        // Assertion pour vérifier si le résultat est celui attendu
        if ($resultat === 5) {
            echo "Test réussi : 2 + 3 = 5\n";
        } else {
            echo "Test échoué : 2 + 3 devrait être égal à 5, mais obtenu $resultat\n";
        }
    }
}

// Exécution du test
$test = new CalculatriceTest();
$test->testAdditionner();
Copy

Dans cet exemple, nous avons créé une classe CalculatriceTest avec une méthode testAdditionner() qui teste la méthode additionner() de la classe Calculatrice. Nous appelons la méthode additionner() avec des valeurs d'entrée connues (2 et 3) et vérifions si le résultat est égal à 5 en utilisant une simple instruction if. Nous affichons ensuite un message indiquant si le test a réussi ou échoué.

L'exécution de ce script affichera un message indiquant si le test a réussi ou échoué.

C'est un petit peu ce qu'il se passe dans PHPUnit, mais en version à la main ! En gros, utiliser PHPUnit, c'est ne pas réinventer la roue, ne pas commencer à traiter tous nos cas (classique) à la main. Bien sûr, les cas plus complexes devront être créé par vous ! Tous les tests n'existent pas tout fait, mais pour des opérations de petites et moyennes complexités, surtout populaire, la plupart des tests sont déjà existants !