Configuración en testing en Symfony

Podemos configurar el cliente en los functional tests o el archivo de configuración phpunit.xml.dist para adaptarlo a nuestras necesidades

Contenido modificable

Si ves errores o quieres modificar/añadir contenidos, puedes crear un pull request. Gracias

El Client utilizado por functional tests crea un Kernel que se ejecuta en un entorno especial test. Ya que Symfony carga el archivo app/config/config_test.yml en el entorno test, puedes retocar cualquier ajuste de la aplicación específicamente para el testeo.

Por ejemplo, por defecto, el Swift Mailer está configurado para no enviar emails en el entorno test. Puedes verlo en las opciones de configuración de swiftwailer:

# app/config/config_test.yml

# ...
swiftmailer:
    disable_delivery: true

Puedes también utilizar un entorno totalmente diferente, o sobreescribir el modo debug por defecto (true) pasando cada uno como opciones al método createClient():

$client = static::createClient(array(
    'environment' => 'my_test_env',
    'debug'       => false,
));

Si tu aplicación varía en función de algunos headers HTTP, pásalos como segundo argumento de createClient():

$client = static::createClient(array(), array(
    'HTTP_HOST'       => 'en.example.com',
    'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
));

También puedes sobreescribir headers HTTP por cada request:

$client->request('GET', '/', array(), array(), array(
    'HTTP_HOST'       => 'en.example.com',
    'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
));

El cliente test está disponible como service en el container en el entorno test (o donde esté activada la opción framework.test). Esto significa que puedes sobreescribir el service completamente si lo necesitas.

Configuración de PHPUnit

Cada aplicación tiene su propia configuración PHPUnit, guardada en el archivo phpunit.xml.dist. Puedes editar este archivo para cambiar los valores por defecto o crear un archivo phpunit.xml para establecer una configuración sólo para tu entorno local. Recuerda guardar el phpunit.xml.dist en el repositorio de la aplicación e ignorar el archivo phpunit.xml.

Por defecto sólo los tests guardados en /tests se ejecutan a través del comando phpunit, tal y como está configurado en el archivo phpunit.xml.dist:

<!-- phpunit.xml.dist -->
<phpunit>
    <!-- ... -->
    <testsuites>
        <testsuite name="Project Test Suite">
            <directory>tests</directory>
        </testsuite>
    </testsuites>
    <!-- ... -->
</phpunit>

Pero puedes añadir más directorios fácilmente. Por ejemplo, la siguiente configuración añade tests desde un directorio propio lib/tests:

<!-- phpunit.xml.dist -->
<phpunit>
    <!-- ... -->
    <testsuites>
        <testsuite name="Project Test Suite">
            <!-- ... --->
            <directory>../lib/tests</directory>
        </testsuite>
    </testsuites>
    <!-- ... --->
</phpunit>

Para incluir otros directorios en la cobertura del código, edita también la sección filter:

<!-- phpunit.xml.dist -->
<phpunit>
    <!-- ... -->
    <filter>
        <whitelist>
            <!-- ... -->
            <directory>../lib</directory>
            <exclude>
                <!-- ... -->
                <directory>../lib/tests</directory>
            </exclude>
        </whitelist>
    </filter>
    <!-- ... --->
</phpunit>