Migraciones

1. Introducción

En proyectos reales, En el desarrollo de una aplicación, suele ocurrir que el esquema de base de datos cambia continuamente: se añaden campos, se refactorizan tablas, se crean relaciones, se aplican restricciones, etc. Hacer estos cambios a mano en phpMyAdmin (o en un SQL suelto) suele romper la trazabilidad, dificulta el trabajo en equipo y hace frágiles los despliegues entre entornos (local, preproducción, producción).

Es cierto que una vez desarrollada la aplicación, la base de datos sigue siendo un elemento crítico, pero menos frecuentes, presentando pocos cambios (es algo ideal…).

Laravel resuelve esto con migraciones: una forma versionada, repetible y automatizable de definir la estructura de la base de datos como código. En un equipo, todos comparten el mismo histórico de cambios, y el proyecto puede “levantar” la base de datos desde cero de forma consistente.

A su vez, laravel nos va a ofrecer la posibilidad de poblar de forma automatizada las tablas de la base de datos, constituyendo un entorno ideal para poder probar nuestra aplicación según la vamos desarrollando.

Estos datos serán datos fictícios o datos faker, y constituirán un entorno ideal para poder probar nuestra aplicación.

## Ejemplos de métodos disponibles
use Illuminate\Support\Facades\Schema;

    Schema::create()
    Schema::table()
    $table->string()
    $table->integer()
    $table->foreignId()
    $table->timestamps()
    $table->unique()

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

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('student', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->string('password');
            $table->string('address');
            $table->timestamps();
        });

up() / down()

  public function up(): void
    {
        Schema::create('student', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            });
    }
  public function down(): void
    {
        Schema::dropIfExists('student');
   }

Las migraciones

Las migraciones se guardan en: database/migrations

Laravel registra qué migraciones se han ejecutado en una tabla interna llamada migrations

Aunque es algo que no vamos a usar, es interesante saber que el proyecto guarda el histórico de cambios en Git y la base de datos guarda el “estado aplicado” en la tabla migrations. Podríamos deshacer los 3 ultimos cambios por ejemplo o el último o deshacer todo, como veremos a continuación

Acciones concretas

1. Crear migración (nombra el cambio)
2. Programar up() y down() (reversible)
3. Ejecutar migrate (aplica en tu DB local)
4. Subir cambios a Git
5. En otro entorno (otro compañero / servidor), ejecutar migrate y obtener el mismo esquema

    php artisan make:migration create_students_table

2.- Modificar una tabla existente

php artisan make:migration add_phone_to_students_table

3.-Crear migración y modelo a la vez (opcional, pero común) Aunque no hemos visto qué es un modelo, lo vamos a necesitar para interactuar con la base de datos desde nuestra aplicación Lo estudiamos en el tema de modelos

php artisan make:model Student -m

Convención de nombres :

• create_x_table para crear
• add_y_to_x_table para añadir
• remove_y_from_x_table para eliminar
• update_x_table o change_y_in_x_table para cambios complejos

Estructura de una migración

Una migración típica tiene esta forma:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

<?php

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

return new class extends Migration
{
    public function up(): void
    {
        Schema::create('students', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('students');
    }
};

Puntos importantes :

• Schema::create define una tabla desde cero
• Blueprint $table define columnas, índices, etc.
• down() revierte de forma segura con dropIfExists
• up() Ejecuta la migración creando los elementos especificados (crear o modificar)

Ejecutar migraciones

Las principales acciones que vamos a realizar con las migraciones son las siguientes

Ejecutar todas las migraciones pendientes

php artisan migrate

Consultar el estado de las migraciones

1

php artisan migrate:status

Deshacer última acción (última migración ejecutado)

1

php artisan migrate:rollback

Deshacer las últimas N migraciones ejecutadas

1

php artisan migrate:rollback --step=3

Reiniciar el esquema completo (rollback total + migrate)

1

php artisan migrate:refresh

Borrar todas las tablas y volverlo a crear (muy usado en desarrollo) Esta acción la haremos con mucha frecuencia

1

php artisan migrate:fresh

Borrar todo y además ejecutar los seeders

1

php artisan migrate:fresh --seed

• fresh es ideal para desarrollo local cuando puedes perder datos
• en producción casi siempre se usa migrate (nunca fresh)

4.6. Tipos de columnas más habituales (Laravel 12)

• id(): BIGINT autoincremental
• timestamps(): created_at / updated_at
• softDeletes(): deleted_at para borrado lógico

1
2
3
4
5

Schema::create('students', function (Blueprint $table) {
    $table->id();
    $table->timestamps();
    $table->softDeletes();
});

• string: VARCHAR(255) por defecto
• text: TEXT
• integer, bigInteger
• decimal(8,2) para importes
• boolean

1
2
3
4
5
6
7

Schema::table('students', function (Blueprint $table) {
    $table->string('name', 120);
    $table->text('notes')->nullable();
    $table->integer('age')->nullable();
    $table->decimal('tuition_fee', 8, 2)->default(0);
    $table->boolean('active')->default(true);
});

• date, time, dateTime
• timestamp

1
2
3
4

Schema::table('students', function (Blueprint $table) {
    $table->date('birth_date')->nullable();
    $table->dateTime('last_login_at')->nullable();
});

Índices y restricciones: performance + integridad

El tema de índices es muy importante y lo tenemos que tener muy claro

• index() acelera búsquedas
• unique() evita duplicados

1
2
3
4

Schema::table('students', function (Blueprint $table) {
    $table->string('dni', 12)->unique();
    $table->string('city')->index();
});

Regla práctica :

• index: para columnas que se filtran mucho (where)
• unique: para “identificadores” (email, dni, código, etc.)

referencias

• 

  Migraciones y Schema Builder

  🌐

  Documentación oficial de Laravel: Migrations / Schema Builder
• 

  Comandos Artisan para migraciones

  🌐

  Artisan: comandos de migración (migrate, rollback, fresh, status)