Pruebas de Datos en Bases de Datos con PHP y Laravel

Clase 13 de 24 • Curso Básico de Testing con PHP y Laravel

Resumen

¿Cómo testear datos desde una base de datos en Laravel?

Testear datos en una base de datos es crucial para asegurar que nuestras aplicaciones funcionen correctamente. En este contexto, vamos a explorar cómo realizar pruebas sobre las bases de datos utilizando Laravel. Aprenderemos cómo crear clases de prueba, cómo configurar el entorno de testing y ejecutar los test de manera efectiva.

¿Cómo iniciar una clase de test en Laravel?

Comenzamos creando una clase de prueba específica para verificar los elementos de nuestra base de datos. Podemos hacerlo utilizando el siguiente comando de Artisan:

php artisan make:test UserTest --unit

Una vez creado, encontramos la nueva clase dentro de la carpeta tests/Unit, con el patrón de nombre UserTest. Este archivo nos permite configurar las pruebas que deseamos realizar sobre el modelo en cuestión.

¿Cómo asegurarnos de que los datos existan en la base de datos?

Para verificar que cierto dato exista en la base de datos durante nuestros test, podemos usar el método assertDatabaseHas. Este método nos sirve para confirmar que un registro con campos específicos está presente en la base de datos. Veamos un ejemplo en el que comprobamos si existe un usuario con un email específico:

$this->assertDatabaseHas('users', [
    'email' => 'admin@example.com'
]);

¿Cómo configurar el entorno de pruebas sin afectar la base de datos real?

Es imperativo no modificar nuestra base de datos real durante las pruebas. Por lo tanto, debemos configurar una base de datos para pruebas (en memoria) utilizando SQLite. Esta configuración se realiza en el archivo phpunit.xml:

Descomentamos o agregamos las líneas relativas a SQLite.
Configuramos para usar DB_CONNECTION=sqlite y DB_DATABASE=:memory: que permiten realizar pruebas sobre una base de datos temporal.

Esta configuración garantiza que cualquier cambio temporal realizado durante las pruebas no tendrá efecto en los datos reales.

¿Cómo ejecutar los test y resolver errores comunes?

Después de preparar nuestras pruebas y configurar adecuadamente el entorno, ejecutamos nuestros test usando el siguiente comando de Artisan:

php artisan test --filter=UserTest

Si encontramos errores, como que las pruebas no se ejecutan, es posible que se deba a que el entorno no estaba correctamente configurado o se olvidó guardar algunos cambios importantes en los archivos de prueba.

Al enfrentarnos con estos problemas, es útil:

Verificar que todos los archivos están guardados.
Revisar que la configuración del entorno de pruebas esté descomentada.
Comprobar que el nombre de los test cases coincida adecuadamente con la definición en nuestros archivos de pruebas.

¿Cómo simular datos para testing?

En algunas ocasiones, necesitamos crear datos ficticios para simular los escenarios de prueba. Laravel proporciona el uso de factories para generar estos datos. Puede hacerse de la siguiente forma:

User::factory()->create([
    'email' => 'test@admin.com'
]);

Se asegura, así, que el correo electrónico test@admin.com exista para las pruebas, permitiéndonos verificar la existencia de registros específicos.

Testear adecuadamente los datos en una base de datos no solo mejora la calidad del software, sino que también garantiza que los usuarios finales experimenten un funcionamiento correcto y sin errores. ¡Continúa aprendiendo y profundizando en estos temas para convertirte en experto en Laravel!

Carlos Eduardo Gomez García

teacher•

Vale, por si a alguien le sale el error could not find driver (SQL: PRAGMA foreign_keys = ON;) . Lo que tienen que hacer es dos cosas: .

Ir a su archivo php.ini (en Linux está ubicado en /etc/php/php8.0/apache2/php.ini en mi caso tengo la versión 8.0, revisa cuál es la tuya) y aquí buscar la línea ;extension=pdo_sqlite, simplemente le quitan ese ";" del inicio y guardan el archivo
En caso de que aún no puedan, lo más probable es que no tengan la extensión instalada, para este caso (en Linux), puede usar el comando sudo apt install php8.0-sqlite3, con eso se instala el driver que conecta a PHP con sqlite, en mi caso estoy usando PHP 8.0, por cada versión de PHP existirá un driver

. En teoría eso debería solucionar el problema 🤔 He visto por ahí que algunos tienen que crear un archivo llamado database.sqlite dentro del directorio database, aunque en mi caso no fue necesaro :D

KEVIN BRAYAN LUNA FIGUEROA

student•

Gracias por aporte, si me funciono :)

enderson omaña

student•

Muchas gracias

Fernando Michel Baladi Tahan

student•

Hola, quería comentarles que considero que esta clase debería haber estado antes al inicio del curso o en los otros cursos de Laravel. El testing es muy poderoso, sobre todo con comandos como "RefreshDatabase", porque al correrlo sin estar en un ambiente de pruebas, la base de datos se migra por completo de nuevo, pudiendo perder así una buena cantidad de información.

Byron Jimenez

student•

Justo me pasó, perdí meses de información en el ambiente de pruebas (el equipo hasta ahora quizo integrar testing en el proyecto) ya que en la documentación no especifica ese problema

Brian Sánchez Izquierdo

student•

Que vaciado, a mi también a veces me pasa lo de no guardar jaja. Motiva ver que hasta los profesionales pueden equivocarse así.

Alejandro Madrid Felizzola

student•

Alguno tiene este error en windows?

SQLSTATE[HY000] [1049] Unknown database ':memory:' (SQL: select * from information_schema.tables where table_schema = :memory: and table_name = migrations and table_type = 'BASE TABLE')

DANIEL OMAR ESTEVES

student•

Hola, en el archivo phpunit.xml deberia estar de la siguiente forma

    <env name="DB_CONNECTION" value="sqlite"/>
    <env name="DB_DATABASE" value=":memory:"/>

Alejandro Valenzuela

student•

Buenas, tengo una duda la cual no pude solucionarla, a los test los configure para que se ejecuten con sqlite, el tema es que cuando ejecuto me tirar error:

Failed asserting that false is true.

Mi test:

 /** @test */
    public function get_all_events()
    {
        $this->withoutExceptionHandling();
        factory(ClinicsClasses::class)->create();
        factory(Gallery::class)->create();
        factory(Event::class, 2)
            ->create([
                'main' => true,
                'display_until' => date(
                    Carbon::now()->isoFormat('Y-M-d H:i:s')
                ),
            ])
            ->toArray();
        $data = ['main' => true];
        $this->call('GET', '/api/events/', $data)       
            ->assertJsonFragment(['main' => true]) //Esto genera error
            ->assertJsonCount(2)
            ->assertStatus(Response::HTTP_OK);
    }

y si ejecuto este mismo test con postgres pasa sin problema. Ahora pero si cambio a:

->assertJsonFragment(['main' => '1'])

pasa sin problema utlizando Sqlite.

Alguna sugerencia de como solucionar, desde ya muchas gracias.

Cristian Pisco Intriago

student•

Hola, en lo personal no recomiendo realizar pruebas unitarias con sqlite porque genera falsos positivos, el problema que tú tienes es un falso positivo. Sugeriría utilizar el mismo motor de base de datos de tu aplicación. En el archivo phpunit.xml haz lo siguiente: Elimina el tag "DB_CONNECTION". Modifica el tag "DB_DATABASE" y coloca el nombre de la base de datos de prueba. Ejemplo:

<php>
	<server name="DB_DATABASE" value="dbname_test"/>
</php>

Supongamos que tu base de datos se llama "dbname", vas a crear una migración a la base "dbname" y después ejecutas otra migración a la base "dbname_test". En las pruebas unitarias vas a trabajar con la base dbname_test. Ambas bases de datos son redundantes, deben tener las mismas tablas, columnas, etc.

Respondiendo al problema que tienes, hay ciertos motores de bases de datos que no soportan booleanos, entre ellos Sqlite, en ese caso trabajan con otro tipo de dato llamado "TINYINT" que toma dos valores 0 o 1. https://www.sqlite.org/datatype3.html --> Sección 2.1

Existe un mecanismo para que laravel considere un atributo como booleano, tienes que crear un casting en el modelo.

protected $casts = [
        'main' => 'boolean',
];

Nota: No se aplica el casting si el atributo es NULL. Nunca definas un casting a un atributo cuyo nombre es igual al nombre de una función que representa una relación; es decir, si tu modelo tiene una relación de uno a muchos y el nombre de esa función que representa la relación se llama "admin", no realices un casting a un atributo llamado "admin" porque va a generar conflicto. https://laravel.com/docs/8.x/eloquent-mutators#attribute-casting

Alejandro Valenzuela

student•

Gracias @cristianpisco por contestar mi consulta, si tendré que usar otra db para test gracias por el consejo. Tuve mucho problema con sqlite por ejemplo en las migraciones esto me tiraba error:

Schema::table('events', function (Blueprint $table) {
            $table->dropColumn('start_time');
            $table->dropColumn('end_time');
});

y lo solucionabas :

 Schema::table('events', function (Blueprint $table) {
            $table->dropColumn(['start_time', 'end_time']);
 });

e inclusive en clave foráneas porque me generaba un numero pero string y decidí como dices tu usar otra db. Desde ya muchas gracias. Saludos

Julian David Alzate Cuervo

student•

Si les sale un error
could not find driver (SQL: PRAGMA foreign_keys = ON;)

ir a las carpetad en Laragon: laragon\bin\php\php

y en ;extension=pdo_sqlite quitar el punto y coma

Juan Ortega

student•

Hola!.

Por si alguien implementa los Tests Funcionales con browser para simular la interacción de un usuario con la plataforma (Laravel Dusk).

He estado viendo en la documentación que se recomienda el uso del trait DatabaseTruncation para agilizar las tareas de creación de datos en las tablas y borrado por cada Test que se lanza

use Illuminate\Foundation\Testing\DatabaseTruncation;

y que se desaconseja el uso de SQLite en memoria

SQLite in-memory databases may not be used when executing Dusk tests. Since the browser executes within its own process, it will not be able to access the in-memory databases of other processes.

Espero que os sirva

Daniel Antonio

student•

Algo importante que me tomo días observar es que me marcaba erro en conexión y es que por alguna razón me importo mal una clase y hablo de :

use PHPUnit\Framework\TestCase;

y que en realidad es use

use Tests\TestCase;

ojo con eso

Manuel Medina

student•

Si les marcaba el siguiente error
Call to undefined method App\User::factory() Lo solucioné con esto

factory('App\User')->create([
            'email' => 'sally@example.com'
        ]);

Juan Felipe Lara Martinez

student•

Ese error te sale por que estas usando una versión de larval anterior a 8.0. Ver documentación.

https://laravel.com/docs/8.x/database-testing

Sebastian Sulbaran

student•

Se tiene que usar la ruta al modelo user que generalmente es : use App\Models\User;