Configuración de Relaciones y Pruebas Unitarias en Laravel

Clase 4 de 23 • Curso de Desarrollo en Laravel con Test Driven Development

Resumen

¿Cómo se relacionan las tablas en un proyecto Laravel?

Comenzar un proyecto en Laravel requiere establecer relaciones entre tablas, fundamentales para desarrollar una aplicación robusta. Esto se logra a través del "testing", asegurando que el método específico funcione adecuadamente. En este caso, configuraremos la relación "HasMany" para asegurar que un usuario pueda tener varios repositorios.

¿Cómo crear un archivo de prueba en Laravel?

Para establecer y probar nuestras relaciones, primero debemos crear un archivo de prueba unitario. Esto se logra con el comando de Artisan para crear un test:

php artisan make:test UserTest --unit

Dentro de este archivo configuraremos una relación de que un usuario tiene muchos repositorios. Es crucial que el título del método en el test describa claramente la función que realiza, como en este caso HasMany.

¿Cómo instanciar un usuario y asociar repositorios?

El paso siguiente es crear un usuario y asegurarse de que puede tener múltiples repositorios. Para esto, emplearemos el método HasMany en el modelo de usuario.

public function test_user_has_many_repositories()
{
    $user = User::factory()->create();
    $this->assertInstanceOf("Illuminate\Database\Eloquent\Collection", $user->repositorios);
}

Este fragmento de código verifica si el método user->repositorios retorna una instancia de una colección de datos, es decir, múltiples repositorios.

¿Cómo crear el modelo y configurar la relación?

Ahora, debemos crear el modelo para los repositorios y configurar nuestra relación en el modelo de usuario.

Crear el modelo de repositorio junto con su migración y fábrica:

php artisan make:model Repositorio -m -f

Configurar la relación en el modelo User.php:

public function repositorios()
{
    return $this->hasMany(Repositorio::class);
}

Con este código, especificamos que un usuario puede tener múltiples repositorios.

¿Qué hacer si fallan las pruebas?

Usualmente, al ejecutar tus pruebas notarás errores derivados de configuraciones faltantes o incorrectas. Asegúrate de que estás utilizando el test case correcto. Si estás utilizando Laravel, es preferible usar el test case proporcionado por Laravel que integra phpUnit y simplifica ciertas configuraciones.

php artisan test

Al correr este comando, verificamos que nuestra configuración de relación entre usuario y repositorios funcione correctamente sin errores.

Incorporar esta configuración en tus proyectos te asegura que tienes una base sólida y testeada, permitiendo un desarrollo más eficiente y fluido. ¡Sigue aprendiendo y desarrollando tus habilidades en desarrollo de software!

Brian Sánchez Izquierdo

student•

Para que no salten errores, debido a que Laravel te instala muchos tests de ejemplo, puedes usar la bandera --filter y darle el nombre test_has_many_repositories para que solo se ejecute ese test.

Cesar More Sanchez

student•

Gracias!!!!

Iván Portillo Pérez

student•

si en el --filter indicas unit . Solo corre los test de esa carpeta y no tiene en cuenta los de la carpeta Feature.

Àlex Serra N

student•

Hacer que exista relación entre una tabla y otra a través del testing.

Si queremos hacer test a un modelo concreto por ejemplo, lo haremos de la siguiente forma: php artisan make:test Models/UserTest --unit.

Vamos a comprobar si un usuario tiene muchos repositorios.

Creamos el modelo de lo que queremos que pueda tener varios un usuario, en ese caso repositorios. php artisan make:model Repository -mf. Con -mf creamos el modelo y el factory.

Una vez hecho debemos ir al modelo que queremos que conecte, en ese caso users e indicarle:

public function repositories()
{
  return $this->hasMany(Repository::class);
}

Vamos a testear con php artisan test --filter UserTest (eso para que no nos haga todos los test que ya trae consigo)

Nos habla de la conexión.

Debemos darnos cuenta de que eso es porque en el test UserTest.php estamos usando directamente PHPUnit con el use PHPUnit\Framework\TestCase;. Lo debemos cambiar a use Tests\TestCase; que también nos acabará llegando a PHPUnit de igual manera pero añadiendo la configuración optimizada para Laravel.

Ahora si volvemos a ejecutar php artisan test --filter UserTest ya nos indica PASS, todo correcto!

Seguimos, pues :D

Jimmy Buriticá Londoño

student•

Es un buen aporte comentar las líneas de código. Gracias.

Mariano Gastón Paduani

student•

Excelente aporte!!! Gracias!!!

Carlos Eduardo Gomez García

teacher•

Algo importante, al parecer (o al menos este fue mi caso), hay una nueva actualización de Laravel 8 en donde ahora trae incluidos varios tests por defecto en la carpeta ```Feature``, recomiendo eliminarlos, ya que como aún no hemos configurado la base de datos ni nada te va a llenar la consola de errores, para seguir el curso tal cual es mejor eliminarlo :D

Martín S. Campos

student•

Para ello solo descomenta en el archivo phpunit lo siguiente

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

Marcos Aguirre Miñarro

student•

Tras descomentar las lineas del fichero phpunit.xml relativas al uso de la base de datos me pasan practicamente todos los test, salvo los que renderizan vistas. Voy a comentar dichos métodos en lugar de eliminarlos, aunque creo que eliminarlos también es una opción válida. Buen curso a todos!!

LEONARD CUENCA

student•

Clase 4: Relaciones: múltiples

Creamos nuestra primera prueba test usando el comando:

php artisan make:test Models/UserTest --unit
Creamos el modelo repositorio php artisan make:model Repository -mf

Nota: Cambiamos la clase debido que Laravel ya utiliza PHPUnit en su sistema de testing, pero además le añade cierta configuración y métodos que hace mucho más óptimo el testeo. Fíjate que hay dos maneras de testear, una es ejecutando vendor/bin/phpunit y la otra es php artisan test. Nosotros utilizamos php artisan test y es por eso que cambiamos la clase, para obtener toda la configuración optimizada que nos provee Laravel. {by Gabriel Rodriguez, Hace 9 Meses}

<?php

namespace Tests\Unit\Models;

use App\Models\User;
use Illuminate\Database\Eloquent\Collection;
// use PHPUnit\Framework\TestCase;
use Tests\TestCase;


class UserTest extends TestCase
{
    public function test_has_many_repositorios(){

        $user= new User; 
        Self::assertInstanceOf(Collection::class, $user->repositories);
    }
}

Brian Sánchez Izquierdo

student•

No entendí porque cambiamos la clase para usar TestCase, osea, según el profe estábamos utilizando el TestCase de PhpUnit directamente, pero lo cambiamos para utilizar el TestCase propio de Laravel que a su vez usa el TestCase de PHPUnit, entonces porque hicimos el cambio? No me queda claro del todo.

Gabriel Rodriguez

student•

Cambiamos la clase debido que Laravel ya utiliza PHPUnit en su sistema de testing, pero además le añade cierta configuración y métodos que hace mucho más óptimo el testeo. Fíjate que hay dos maneras de testear, una es ejecutando vendor/bin/phpunit y la otra es php artisan test. Nosotros utilizamos php artisan test y es por eso que cambiamos la clase, para obtener toda la configuración optimizada que nos provee Laravel.

Camilo José Mezú Mina

student•

Gabriel, de que otra manera se puede solucionar el error?

Adrian Peralta

student•

php artisan make:test Models/UserTest --unit
# Crear modelo con migración y factory
php artisan make:model Repository -mf

modificados:

tests/Feature/ExampleTest.php [DEL]
tests/Unit/ExampleTest.php [DEL]
tests/Unit/Models/UserTest.php
- test_has_many_repositories
app/models/User.php

Carlos Julian Grisales Alvarez

student•

No entiendo por que no pasan los tests:

Italo Morales Fantone

teacher•

¿Lo lograste?

Maby Gavilan Abanto

student•

Hola, Tengo un inconveniente:

╰─○ php artisan test --filter UserTest
PHP Fatal error:  Trait "Laravel\Sanctum\HasApiTokens" not found in /home/sherwood/Documents/Learning/Laravel/tdd/app/Models/User.php on line 13

In User.php line 13:
                                                  
  Trait "Laravel\Sanctum\HasApiTokens" not found  
                                                  
```Saben a qué se deba esto?

Brian Sánchez Izquierdo

student•

Cual es la diferencia entre crear la instancia con la palabra reservada new y sólo crearla sin la palabra reservada new?

Carlos Eduardo Gomez García

teacher•

¡Hola!, ¿en qué lugar se usó sin la palabra new? En PHP siempre se debe usar con la palabra new, de lo contrario dará un error 🤔

Kenneth Angulo L

student•

Para poner un poco de contexto:

El proyecto ficticio tiene dos entidades: Users y Repositories.

Entre las dos hay una relación uno a muchos (User ->> Repository) : Un Usuario puede tener muchos repositorios y un Repositorio pertenece a un Usuario.

<u>En estas primeras clases se escribirán los Test para comprobar que esas relaciones son ciertas.</u>

Mauricio Galvez

student•

Me parece que tiene más sentido testear la relación en vez del resultado de la misma.

<?php

namespace Tests\Unit\Models;

use App\Models\User;
use Tests\TestCase;
use Illuminate\Database\Eloquent\Relations\HasMany;

class UserTest extends TestCase
{
    public function test_has_many_repositories()
    {
        $user = new User();

        $this->assertInstanceOf(HasMany::class, $user->repositories());
    }
}

Angel Hernández Nava

student•

Testeó el resultado porque si te fijas es una a muchos, o sea que está esperando que traiga una colección.

De haber puesto la relación por ejemplo como belongsTo o hasOne, habría fallado, porque esas relaciones no regresan una colección

Miguel Angel Ramos Lopez

student•

Saludos a todos. Me ayudan por fa, en la consola me da el siguiente error.

FAILED Tests\Unit\Models\UserTest > has many repositories Error Class "App\Models\Respository" not found

Jorge Bou-saad

student•

Recomiendo PHPStorm como IDE porque al llamar a una instancia de una clase dentro de Laravel o de un paquete, automaticamente te importa su uso. Para trabajar con PHP lo recomiendo muchisimo

JuanC M

student•

Visual tambièn logra ser un buen IDE para php, recomiendo 2 extensiones clave para las instancias:

Para uso general de php

Edgar Alejandro España Amaya

student•

Cuando ejecutaba el comando =>

php artisan test --filter UserTest

Me generaba el siguiente error =>

Class 'PHPUnit\TextUI\XmlConfiguration\ExtensionCollection' not found

Ya que no habían archivos en la carpeta XmlConfiguration, decidí eliminar la carpeta phpunit y ejecutar el comando

composer update phpunit

y me descargo los archivos y ejecute la prueba de manera correcta.

Sistemas Cares

student•

Si alguien recibe No tests executed! luego de hacer un php artisan test y ejecutando

vendor/bin/phpunit ./tests/Unit

les funciona, la respuesta está acá: https://stackoverflow.com/questions/65064182/phpunit-always-output-no-tests-executed-on-macos-big-sur

Pueden sobreescribir la versión de PHP o bien ejecutarlo con lo que les funciona, incluso filtrando este método:

vendor/bin/phpunit ./tests/Unit/Models/UserTest.php --filter=test_has_many_repositories

Brian Sánchez Izquierdo

student•

¿Cómo podría probar la relación 1 a 1, osea donde un modelo Microcontrolador tiene un modelo Proyecto?

Tengo en mi modelo de Microcontrolador el siguiente método:

public function project()
{
	return $this->hasOne( Project::class );
}

y en mi modelo Proyecto tengo el siguiente método:

public function Microcontrolador()
{
	return $this->belongsTo( Microcontrolador::class );
}

Brian Sánchez Izquierdo

student•

Hola, lo resolví de la siguiente manera

public function test_project_has_one_microcontrolador()
{
	Microcontrolador::factory()->create([
		'project_id' => $project = Project::factory()->create()
	]);

	$this
		->assertInstanceOf( Microcontrolador::class, $project->microcontrolador )
}

Héctor Tello

student•

Si a alguno le sucede que al ejecutar la prueba, les aparece el siguiente error:

Argument #1 of PHPUnit\Framework\Assert::assertInstanceOf() must be a class or interface name

no olviden importar Collection, agregando esto:

use Illuminate\Database\Eloquent\Collection;

con eso ya debería funcionar

Mariano Gastón Paduani

student•

Gracias!