Migraciones de Laravel: añadir una columna, revertir y eliminar

Las migraciones versionan el esquema de tu base igual que Git versiona tu código: cada cambio es un archivo, reproducible en cualquier entorno. Tres operaciones cubren casi todo el día a día: añadir una columna a una tabla que ya existe, revertir una migración y eliminar un archivo que nunca se debería haber creado.

Artículo del itinerario Desarrollo web. Todos los comandos y las salidas que verás a continuación se han ejecutado en Laravel 13.30.1 con PHP 8.4.25.

Crear una migración

El comando sigue una convención de nombres que determina el contenido del archivo generado:

php artisan make:migration create_tasks_table

El nombre empieza por create, seguido del nombre de la tabla en plural, seguido de table. Laravel reconoce este patrón y rellena de antemano Schema::create() con id() y timestamps(), la columna title se añade aquí para el ejemplo, y se han quitado los comentarios generados:

<?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('tasks', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->timestamps();
        });
    }

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

Si la tabla tiene que llevar fechas de creación y de modificación, $table->timestamps() las añade: sin ellas aparece el error «Unknown column ‘updated_at’».

Ejecutar la migración crea la tabla:

php artisan migrate

Añadir una columna a una tabla existente

Una vez montado el esquema, las consultas Eloquent habituales hacen el resto. No modifiques nunca una migración que ya se ha ejecutado: tus compañeros y tus servidores la han lanzado y no la van a volver a lanzar. Crea una migración nueva, indicando la tabla afectada con --table:

php artisan make:migration add_notes_to_tasks_table --table=tasks

El archivo generado contiene un Schema::table() vacío en los dos sentidos. Rellénalos: la columna en up() y su eliminación en down().

public function up(): void
{
    Schema::table('tasks', function (Blueprint $table) {
        $table->text('notes')->nullable()->after('title');
    });
}

public function down(): void
{
    Schema::table('tasks', function (Blueprint $table) {
        $table->dropColumn('notes');
    });
}

php artisan migrate

  2026_09_02_194036_add_notes_to_tasks_table .................... 47.43ms DONE

Aquí conviene recordar dos precauciones.

Haz que la columna sea nullable, o dale un valor por defecto. En una tabla que ya contiene filas, una columna NOT NULL sin valor por defecto hace fallar la migración: la base no sabe qué escribir en las filas existentes.

Escribe siempre el down(). Es lo que hace reversible la migración. Una migración sin down() convierte cualquier marcha atrás en una intervención manual.

Revertir una migración ya ejecutada

Empieza por mirar en qué punto estás. migrate:status lista cada migración con su lote y su estado:

php artisan migrate:status

  2026_09_02_100000_create_tasks_table ............................... [1] Ran
  2026_09_02_194036_add_notes_to_tasks_table ......................... Pending

Una migración Pending no se ha ejecutado nunca: su archivo se puede borrar directamente. Una migración Ran hay que revertirla antes.

# revierte solo la última migración
php artisan migrate:rollback --step=1

# revierte todo el último lote
php artisan migrate:rollback

El rollback ejecuta el método down(). En el ejemplo anterior, la columna notes desaparece efectivamente de la tabla y la migración vuelve a Pending. Es en ese momento, y no antes, cuando puedes borrar el archivo.

Existen dos comandos vecinos, reservados al desarrollo:

# revierte todo y lo vuelve a ejecutar todo
php artisan migrate:refresh

# elimina todas las tablas y luego lo vuelve a ejecutar todo
php artisan migrate:fresh

Eliminar una migración

No existe ningún make:migration --delete: una migración se elimina borrando su archivo, en database/migrations, la carpeta que devuelve database_path() entre las rutas de la aplicación. La única pregunta es si ya se ha ejecutado.

Nunca se ha ejecutado (estado Pending): borra el archivo, y nada más.

rm database/migrations/2026_09_02_194036_add_notes_to_tasks_table.php

Ya se ha ejecutado (estado Ran): reviértela primero y luego borra el archivo.

php artisan migrate:rollback --step=1
rm database/migrations/2026_09_02_194036_add_notes_to_tasks_table.php

Modificar una columna existente

Para cambiar un tipo, una longitud o la nulabilidad, vuelve a declarar la columna y añade change():

public function up(): void
{
    Schema::table('tasks', function (Blueprint $table) {
        $table->string('title', 500)->change();
    });
}

Buena noticia para quien vuelva de una versión antigua: el paquete doctrine/dbal, obligatorio durante mucho tiempo para esta operación, ya no lo es desde Laravel 11. Verificado en Laravel 13.30.1, donde change() funciona sin ninguna dependencia adicional.