Tema 7 · Migraciones

7. Conexión a Base de Datos y Creación de Tablas con Migraciones (artisan migrate)

Controla versiones de tu base de datos mediante código PHP, define tipos de columnas, índices, claves foráneas y rollback seguro.

¿Qué son las Migraciones y por qué Salvan Proyectos?

Las Migraciones son como el sistema de control de versiones (Git) pero para tu base de datos. En lugar de crear tablas a mano en phpMyAdmin o pasarse scripts SQL desactualizados por correo, todo el esquema se define en archivos PHP estructurados dentro de database/migrations/.

Cualquier miembro del equipo o tu servidor de producción (como tu VPS en OVH) puede sincronizar la base de datos completa con un solo comando:

php artisan migrate

Anatomía de una Clase de Migración

Para crear una migración se utiliza el generador de Artisan:

php artisan make:migration create_cursos_table

Toda migración implementa dos métodos fundamentales:

  • up(): Define los cambios a aplicar (crear la tabla, agregar columnas o índices).
  • down(): Revierte exactamente lo hecho en up() (por ejemplo, Schema::dropIfExists('cursos')).

Tipos de Columnas Comunes en el Schema Builder

Método de Schema Tipo SQL Resultante Modificadores Típicos
$table->id(); BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY Clave primaria estándar.
$table->string('titulo', 150); VARCHAR(150) ->nullable(), ->unique()
$table->text('descripcion'); TEXT Para textos largos o contenidos.
$table->unsignedInteger('precio_cop'); INT UNSIGNED ->default(0)
$table->boolean('is_active'); TINYINT(1) ->default(true)
$table->foreignId('user_id'); BIGINT UNSIGNED (FK) ->constrained()->cascadeOnDelete()
$table->timestamps(); created_at y updated_at Marcas de tiempo automáticas.

Comandos de Control de Migraciones

# Ejecutar las migraciones pendientes
php artisan migrate

# Ver el estado de las migraciones (cuáles se han ejecutado y en qué lote)
php artisan migrate:status

# Revertir el último lote de migraciones
php artisan migrate:rollback

# ¡PELIGRO EN PRODUCCIÓN! Borra todas las tablas y las vuelve a crear desde cero
php artisan migrate:fresh

⚡ Migración Completa de una Tabla de Cursos con Claves Foráneas

Archivo de migración database/migrations/..._create_cursos_table.php listo para producción.

2026_01_01_000000_create_cursos_table.php
Solo lectura
<?php

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

return new class extends Migration
{
    /** Ejecuta las migraciones (crea la tabla) */
    public function up(): void
    {
        Schema::create('cursos', function (Blueprint $table) {
            $table->id();
            
            // Relación con el instructor (FK a tabla users)
            $table->foreignId('instructor_id')
                  ->constrained('users')
                  ->onDelete('cascade');

            $table->string('slug', 120)->unique();
            $table->string('title', 190);
            $table->string('summary', 300);
            $table->longText('description')->nullable();
            
            $table->unsignedInteger('price_cop')->default(0);
            $table->unsignedSmallInteger('hours')->default(40);
            $table->boolean('is_active')->default(true);
            
            // Índices para acelerar búsquedas
            $table->index(['is_active', 'price_cop']);
            
            $table->timestamps(); // created_at y updated_at
        });
    }

    /** Revierte las migraciones (elimina la tabla) */
    public function down(): void
    {
        Schema::dropIfExists('cursos');
    }
};
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué comando de Artisan revierte únicamente el último lote de migraciones ejecutadas sin destruir el resto de las tablas?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Laravel Framework Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.