Guía completa de factories en Laravel

• 20/04/2023

Guía completa de factories en Laravel, ¿qué son?, ¿para qué sirven?

¡Hola!

Laravel es uno de los frameworks de desarrollo de aplicaciones web más populares y utilizados en la actualidad. Una de las características que hace que Laravel sea tan poderoso es su capacidad para simplificar el proceso de desarrollo. Una de las herramientas que utiliza Laravel para lograr esto son los factories. En esta Guía completa de factories en Laravel, explicaremos qué son los factories en Laravel, cómo funcionan y cómo utilizarlos.

Introducción a Laravel

Antes de adentrarnos en esta Guía completa de factories en Laravel factories en Laravel, es importante tener una comprensión básica de Laravel en sí. Laravel es un framework de desarrollo de aplicaciones web PHP de código abierto, diseñado para crear aplicaciones web modernas y robustas de manera más eficiente. Laravel está construido sobre el patrón de arquitectura Modelo-Vista-Controlador (MVC), lo que significa que separa la lógica de la aplicación en tres componentes principales: el modelo, la vista y el controlador.

El modelo se utiliza para interactuar con la base de datos y manejar la lógica del negocio. La vista se encarga de la presentación y la interfaz de usuario, mientras que el controlador actúa como intermediario entre el modelo y la vista.

---

¿Qué son los factories en Laravel?

Los factories son una herramienta que Laravel proporciona para ayudar a simplificar la creación de datos de prueba. Los factories son generadores de datos aleatorios que pueden utilizarse para poblar una base de datos con datos falsos o de prueba. Esto es especialmente útil para desarrolladores que necesitan crear datos de prueba para probar una aplicación sin tener que ingresar manualmente grandes cantidades de datos de prueba en la base de datos.

---

¿Cómo funcionan los factories en Laravel?

Los factories en Laravel funcionan generando datos aleatorios que pueden ser utilizados para poblar una base de datos. Los factories están diseñados para generar datos falsos de manera coherente, lo que significa que los datos generados siempre serán coherentes entre sí. Esto hace que sea fácil generar grandes cantidades de datos de prueba de manera rápida y sencilla.

Los factories se crean utilizando una clase factory. La clase factory define los campos que se van a generar y cómo se van a generar. Por ejemplo, si estuviéramos creando un factory para una tabla de usuarios, podríamos definir que el campo 'nombre' se generará utilizando una lista de nombres aleatorios y que el campo 'email' se generará utilizando una lista de direcciones de correo electrónico aleatorias.

Una vez que se ha creado la clase factory, se puede utilizar para generar datos de prueba. Esto se hace utilizando el método 'create' en la clase factory. El método 'create' crea una instancia del modelo y guarda los datos generados en la base de datos.

---

¿Cómo utilizar los factories en Laravel?

Para utilizar los factories en Laravel, primero necesitamos crear una clase factory. La clase factory debe estar ubicada en el directorio 'database/factories' de nuestro proyecto Laravel. Dentro de la clase factory, definiremos los campos que queremos generar y cómo queremos generarlos.

A continuación, debemos definir un modelo para la tabla de la base de datos que queremos poblar con datos de prueba. El modelo debe tener una correspondencia uno a uno con la tabla de la base de datos y debe estar ubicado en el directorio 'app/Models' de nuestro proyecto Laravel.

Una vez que se ha creado la clase factory y el modelo, podemos utilizar el método 'create' en la clase factory para generar datos de prueba. Por ejemplo, si queremos crear 10 usuarios de prueba, podemos hacer lo siguiente:

use App\Models\User;

User::factory()->count(10)->create();

Este código generará 10 usuarios de prueba utilizando la clase factory 'User', y los guardará en la base de datos utilizando el método 'create'.

También podemos utilizar los factories para generar datos de prueba específicos. Por ejemplo, si queremos crear un usuario de prueba con un nombre y correo electrónico específicos, podemos hacer lo siguiente:

use App\Models\User;

User::factory()->create([
    'name' => 'John Doe',
    'email' => '[email protected]',
]);

Este código generará un usuario de prueba con el nombre 'John Doe' y el correo electrónico '[email protected]'.

---

¿Por qué utilizar los factories en Laravel?

Los factories son una herramienta extremadamente útil para desarrolladores que necesitan generar grandes cantidades de datos de prueba para probar una aplicación. Los factories hacen que sea fácil generar datos de prueba de manera coherente y en grandes cantidades, lo que puede ahorrar tiempo y esfuerzo en el proceso de desarrollo.

Además, los factories pueden ser utilizados para generar datos de prueba que sean coherentes y estén bien estructurados. Esto significa que los desarrolladores pueden estar seguros de que los datos generados son representativos de los datos que encontrarán en la aplicación en producción.

---

Diferencias entre Seeders y Factories en Laravel

En el contexto de Laravel, tanto los Seeders como los Factories son herramientas que se utilizan para generar datos de prueba para una aplicación. Sin embargo, existen algunas diferencias clave entre ellos:

• Propósito Los Seeders se utilizan para poblar la base de datos con datos de prueba, mientras que los Factories se utilizan para generar datos de prueba en tiempo de ejecución.

• Tipo de datos: Los Seeders generan datos fijos y predefinidos, mientras que los Factories generan datos aleatorios y dinámicos.

• Relación con los modelos: Los Seeders están asociados con los modelos de la aplicación y utilizan la sintaxis Eloquent para crear registros en la base de datos, mientras que los Factories están diseñados para generar datos independientes de los modelos.

• Uso: Los Seeders se ejecutan una sola vez para poblar la base de datos con datos de prueba, mientras que los Factories se utilizan en pruebas automatizadas y en el desarrollo de características de la aplicación.

En resumen, los Seeders se utilizan para poblar la base de datos con datos fijos y predefinidos, mientras que los Factories se utilizan para generar datos aleatorios y dinámicos en tiempo de ejecución, y se utilizan principalmente en pruebas automatizadas y en el desarrollo de características de la aplicación.

---

¿Cómo se relacionan los factories con las pruebas en Laravel?

Los factories son una parte importante del proceso de pruebas en Laravel. Laravel proporciona una serie de herramientas para realizar pruebas de unidad y de integración en una aplicación Laravel. Las pruebas de unidad se utilizan para probar la funcionalidad de pequeñas partes de una aplicación, mientras que las pruebas de integración se utilizan para probar la funcionalidad de la aplicación en su conjunto.

Los factories se utilizan en ambos tipos de pruebas para generar datos de prueba para probar la aplicación. Por ejemplo, en una prueba de unidad para una clase de modelo, podríamos utilizar un factory para generar datos de prueba para el modelo. Esto nos permite probar la funcionalidad del modelo sin tener que utilizar datos reales de la base de datos.

---

¿Cómo personalizar los factories en Laravel?

Una forma de personalizar un factory es mediante la definición de atributos personalizados. Para hacer esto, podemos utilizar el método state en el archivo del factory y definir los atributos específicos que queremos agregar. Por ejemplo, si queremos crear un factory para un modelo de usuarios que requiere un nombre de usuario único, podemos definir un atributo personalizado utilizando el método state:

$factory->state(App\User::class, 'unique_username', function (Faker $faker) {
    static $number = 1;

    return [
        'username' => $faker->unique()->userName . $number++,
    ];
});

En este ejemplo, estamos utilizando el método unique de Faker para asegurarnos de que el nombre de usuario generado sea único, y estamos agregando un número incremental para evitar duplicados. Luego, podemos utilizar este estado personalizado para crear usuarios con nombres de usuario únicos:

$user = factory(App\User::class)->states('unique_username')->create();

Otra forma de personalizar un factory es mediante la creación de un factory específico para un modelo. Para hacer esto, podemos crear un nuevo archivo dentro de la carpeta database/factories y definir nuestro factory personalizado. Luego, podemos utilizar el método factoryForModel en lugar del método factory para crear instancias de nuestro modelo utilizando nuestro factory personalizado:

$userFactory = factoryForModel(App\User::class, 'custom', function (Faker $faker) {
    return [
        'name' => $faker->name,
        'email' => $faker->unique()->safeEmail,
    ];
});

$user = $userFactory->create();

En este ejemplo, estamos creando un factory personalizado para el modelo de usuario y utilizando el método factoryForModel para crear instancias de nuestro modelo utilizando nuestro factory personalizado. De esta manera, podemos definir atributos personalizado para nuestro modelo sin afectar a otros factories que se utilizan en nuestra aplicación.

---

Ejemplo Completo Utilizando Factories Laravel

Crear Tabla Tareas

Supongamos que queremos crear una aplicación de lista de tareas. En primer lugar, debemos crear una migración para crear la tabla de tareas en la base de datos. Para ello, podemos ejecutar el siguiente comando en la terminal:

php artisan make:migration create_tareas_table

Esto creará un archivo de migración en el directorio database/migrations, que podemos abrir y modificar para definir los campos de la tabla de tareas.

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('tareas', function (Blueprint $table) {
            $table->id();
            $table->string('titulo');
            $table->string('descripcion');
            $table->smallInteger('completado');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('tareas');
    }
};

img class="img-fluid text-center img-plus text-center" alt="Editar Migración" src="https://dcreations.es/storage/files/1/blog/guia-factories-laravel/editar-migracion.webp">

Por último ejecutamos la migración:

php artisan migrate

Crear Modelo para la tabla Tareas

A continuación, podemos crear un modelo para la tabla de tareas. Podemos ejecutar el siguiente comando en la terminal:

php artisan make:model Tarea

Esto creará un archivo del modelo en el directorio app/Models, que podemos abrir y modificar para definir la relación con la tabla de tareas.

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Tarea extends Model
{
    use HasFactory;

    protected $fillable = [
        'titulo',
        'descripcion',
        'completado'
    ];
}

Crear Factory

Una vez que tenemos la tabla y el modelo creados, podemos utilizar un Factory para generar datos de prueba para la tabla de tareas. Para ello, podemos ejecutar el siguiente comando en la terminal:

php artisan make:factory TareaFactory --model=Tarea

Esto creará un archivo de Factory en el directorio database/factories, que podemos abrir y modificar para definir los datos de prueba que queremos generar.

Por ejemplo, podemos definir el siguiente código en el archivo TareaFactory.php:

<?php

namespace Database\Factories;

use App\Models\Tarea;

use Illuminate\Database\Eloquent\Factories\Factory;

/**
 * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Tarea>
 */
class TareaFactory extends Factory
{

    protected $model = Tarea::class;

    /**
     * Define the model's default state.
     *
     * @return array<string, mixed>
     */
    public function definition()
    {
        return [
            'titulo' => $this->faker->sentence,
            'descripcion' => $this->faker->paragraph,
            'completado' => $this->faker->randomElement([0, 1]),
        ];
    }
}

Este código define un Factory para el modelo Tarea, que generará datos aleatorios para el título, la descripción y el estado de completado de la tarea.

Probar Factory

Para probar el factory creamos un archivo de test:

php artisan make:test TareaTest

Por último, podemos utilizar el Factory para generar datos de prueba en nuestro código de prueba. Por ejemplo, podemos definir el siguiente código en un archivo de prueba en el directorio tests/feature:

<?php

namespace Tests\Feature;

use App\Models\Tarea;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithFaker;
use Tests\TestCase;

class TareaTest extends TestCase
{

    use RefreshDatabase;

    /**
     * Función que crea 10 tareas aleatorias
     *
     * @return void
     */
    public function test_crear_tareas_aleatorias()
    {
        $this->expectNotToPerformAssertions();
        Tarea::factory(10)->create();
    }

    /**
     * Función que crea 1 tarea concreta
     *
     * @return void
     */
    public function test_crear_tarea_concreta()
    {
        $this->expectNotToPerformAssertions();

        $tarea = Tarea::factory()->create([
            'titulo' => 'Nueva Tarea',
            'descripcion' => 'Descripción de la tarea',
            'completado' => 0,
        ]);

    }
}

---

Conclusión

En conclusión, gracias a esta Guía completa de factories deducimos que los factories son una herramienta esencial en Laravel para generar grandes cantidades de datos de prueba de manera fácil y coherente. Esto puede ahorrar tiempo y esfuerzo en el proceso de desarrollo y asegurar que los datos de prueba sean representativos de los datos que se encontrarán en la aplicación en producción. Además, los factories son altamente personalizables, lo que los hace aún más útiles para los desarrolladores.

En resumen, como hemos podido ver en esta guía de factories en Laravel los factories son una herramienta esencial para cualquier desarrollador que trabaje con Laravel y necesite generar datos de prueba de manera eficiente y coherente.