Unit tests en Symfony

Cuando añades cualquier línea de código, puedes añadir también sin quererlo algún bug. Para construir mejores aplicaciones y más estables, lo ideal es testear el código con unit y functional tests.

En Symfony viene incorporado PHPUnit, una librería independiente para testear (documentación).

Cada test es una clase PHP que ha de ir localizada en el directorio /tests, de esta forma basta con ejecutar el siguiente comando:

phpunit

La configuración de PHPUnit se encuentra en el archivo phpunit.xml.dist, en el directorio root de tu aplicación Symfony.

Unit Tests

Los unit tests comprueban una clase específica, también llamada unit. Para crear Symfony unit tests se hace de la misma forma que para crear PHPUnit tests. Si por ejemplo tenemos una clase Calculator en el directorio /Util del bundle AppBundle:

// src/AppBundle/Util/Calculator.php
namespace AppBundle\Util;

class Calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }
}

Para testear al código anterior, creamos un archivo CalculatorTest en el directorio tests/AppBundle/Util:

// tests/AppBundle/Util/CalculatorTest.php
namespace Tests\AppBundle\Util;

use AppBundle\Util\Calculator;

class CalculatorTest extends \PHPUnit_Framework_TestCase
{
    public function testAdd()
    {
        $calc = new Calculator();
        $result = $calc->add(30, 12);

        // nos aseguramos que la calculadora ha sumado los números correctamente
        $this->assertEquals(42, $result);
    }
}

Por convención, el directorio Tests/AppBundle debe replicar el directorio de tu bundle para unit tests, por lo que si testeamos una clase en el directorio AppBunde/Util/, añadiremos el test en el directorio tests/AppBundle/Util/.

Al igual que en una aplicación real, autoloading se activa automáticamente a través del archivo autoload.php (tal y como está configurado por defecto en el archivo phpunit.xml.dist).

Ejecutar tests para un determinado archivo o directorio se hace como sigue:

# ejecutar todos los tests de la aplicación
$ phpunit

# ejecutar todos los tests del directorio /Util
$ phpunit tests/AppBundle/Util

# ejecutar los tests de la clase Calculator
$ phpunit tests/AppBundle/Util/CalculatorTest.php

# ejecutar los tests de todo el bundle
$ phpunit tests/AppBundle/