doc/yii2/migracion.md

Migraciones

Documentación oficial

• Crear una migración
• Ejecutar migracion
• Métodos disponibles

Crear una migración <a name="crear-migracion">

php yii migrate/create :nombre_migración:

donde: :nombre_migracion: es el nombre con el que se creará la migración

ejemplo:

php yii migrate/create catalogo_producto

lo anterior generará un archivo PHP con el nombre m221017_115001_catalogo_producto.php con el siguiente esqueleto de código:

<?php

use yii\db\Migration;

class m221017_115001_catalogo_producto extends Migration {

  /*
  public function up() {
  }

  public function down() {
  }
  */

  // Siempre usar safeUp y safeDown porque se ejecuta con transacción de base de datos
  public function safeUp() {
  }

  public function safeDown() {
  }

}

En el método safeUp debe contener los cambios de la base de datos y en el método safeDown se deben revertir los cambios de safeUp.

Ejecutar migración

Para aplicar los cambios escritos en el método safeUp usar el comando:

php yii migrate

Para revertir los cambios aplicados usar el comando:

php yii migrate/down

Lista de métodos disponibles para la migración

Debajo hay una lista de todos los métodos de acceso a la base de datos:

• execute(): ejecuta una declaración SQL
• insert(): inserta un único registro
• batchInsert(): inserta múltiples registros
• update(): actualiza registros
• delete(): elimina registros
• createTable(): crea una nueva tabla
• renameTable(): renombra una tabla
• dropTable(): elimina una tabla
• truncateTable(): elimina todos los registros de una tabla
• addColumn(): agrega una columna
• renameColumn(): renombra una columna
• dropColumn(): elimina una columna
• alterColumn(): modifica una columna
• addPrimaryKey(): agrega una clave primaria
• dropPrimaryKey(): elimina una clave primaria
• addForeignKey(): agrega una clave foránea
• dropForeignKey(): elimina una clave foránea
• createIndex(): crea un índice
• dropIndex(): elimina un índice
• addCommentOnColumn(): agrega un comentario a una columna
• dropCommentFromColumn(): elimina un comentario de una columna
• addCommentOnTable(): agrega un comentario a una tabla
• dropCommentFromTable(): elimina un comentario de una tabla