Laravel Migration: Sintaxis básica para crear una migración en Laravel

1. Crear una migración en Laravel

En Laravel, las migraciones son una forma conveniente de modificar la estructura de la base de datos de una aplicación. Las migraciones permiten definir los cambios en la estructura de la base de datos utilizando código PHP en lugar de realizar cambios directamente en la base de datos.

Para crear una migración en Laravel, puedes utilizar el comando make:migration de Artisan. Este comando generará un nuevo archivo de migración en el directorio database/migrations de tu proyecto.

El siguiente comando crea una nueva migración:

php artisan make:migration nombre_de_la_migracion

Reemplaza nombre_de_la_migracion con el nombre descriptivo de la migración que estás creando. Por ejemplo, si estás creando una migración para crear una tabla de usuarios, podrías llamarla create_users_table.

Una vez que ejecutes el comando, se generará un nuevo archivo de migración en el directorio database/migrations con un nombre similar a 2021_01_01_000000_nombre_de_la_migracion.php. La fecha y hora en el nombre del archivo aseguran que las migraciones se ejecuten en el orden correcto.

2. Definir la estructura de la tabla

Una vez que hayas creado el archivo de migración, puedes abrirlo y definir la estructura de la tabla que deseas crear o modificar en la base de datos.

El archivo de migración contiene dos métodos principales: up y down. El método up se utiliza para definir los cambios que deseas realizar en la base de datos, mientras que el método down se utiliza para revertir esos cambios en caso de que sea necesario.

Dentro del método up, puedes utilizar los métodos proporcionados por Laravel para definir la estructura de la tabla. Algunos de los métodos más comunes son:

• create: crea una nueva tabla en la base de datos.
• table: modifica una tabla existente en la base de datos.
• drop: elimina una tabla de la base de datos.
• rename: cambia el nombre de una tabla en la base de datos.
• addColumn: agrega una columna a una tabla existente.
• dropColumn: elimina una columna de una tabla existente.

Aquí hay un ejemplo de cómo se vería una migración para crear una tabla de usuarios:

use IlluminateDatabaseMigrationsMigration;
use IlluminateDatabaseSchemaBlueprint;
use IlluminateSupportFacadesSchema;

class CreateUsersTable extends Migration
{
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamp('email_verified_at')->nullable();
            $table->string('password');
            $table->rememberToken();
            $table->timestamps();
        });
    }

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

En este ejemplo, estamos utilizando el método create para crear una nueva tabla llamada «users». Luego, utilizamos los métodos id, string, timestamp, etc., para definir las columnas de la tabla.

Una vez que hayas definido la estructura de la tabla en el método up, también debes definir cómo revertir esos cambios en el método down. En este caso, estamos utilizando el método dropIfExists para eliminar la tabla «users» en caso de que sea necesario revertir la migración.

3. Ejecutar la migración

Una vez que hayas definido la estructura de la tabla en la migración, puedes ejecutar la migración utilizando el comando migrate de Artisan.

php artisan migrate

Este comando ejecutará todas las migraciones que aún no se hayan ejecutado en la base de datos. Laravel realizará un seguimiento de las migraciones que ya se han ejecutado utilizando una tabla llamada migrations en la base de datos.

Si deseas ejecutar una migración específica, puedes utilizar el comando migrate seguido del nombre de la migración:

php artisan migrate --path=/database/migrations/nombre_de_la_migracion.php

Reemplaza nombre_de_la_migracion con el nombre del archivo de migración que deseas ejecutar.

4. Revertir una migración

Si necesitas revertir una migración, puedes utilizar el comando migrate:rollback de Artisan.

php artisan migrate:rollback

Este comando revertirá la última migración que se haya ejecutado en la base de datos. Si deseas revertir varias migraciones, puedes utilizar el comando migrate:rollback seguido del número de migraciones que deseas revertir:

php artisan migrate:rollback --step=3

Este comando revertirá las últimas 3 migraciones que se hayan ejecutado en la base de datos.

5. Verificar el estado de las migraciones

Si deseas verificar el estado de las migraciones en tu base de datos, puedes utilizar el comando migrate:status de Artisan.

php artisan migrate:status

Este comando mostrará una lista de todas las migraciones en tu proyecto, indicando si se han ejecutado o no en la base de datos.

Además, puedes utilizar el comando migrate:status seguido del nombre de una migración para obtener información detallada sobre esa migración en particular:

php artisan migrate:status nombre_de_la_migracion

Reemplaza nombre_de_la_migracion con el nombre del archivo de migración que deseas verificar.

Las migraciones en Laravel son una forma poderosa y conveniente de modificar la estructura de la base de datos de una aplicación. Con la sintaxis básica para crear una migración en Laravel, puedes definir la estructura de la tabla y ejecutar o revertir las migraciones según sea necesario.