Migraciones de Bases de Datos

NOTA: Las migraciones de Phalcon se han quitado de DevTools y se han movido a un repositorio separado.

Repositorio git del paquete

https://github.com/phalcon/migrations

Requerimientos

• PHP >= 7.2
• Phalcon >= 4.0.5

Instalación vía Composer

composer require --dev phalcon/migrations

Inicio rápido

Lo que necesita para un inicio rápido:

• Fichero de configuración en la raíz de su proyecto (también puede pasarlos como parámetros dentro del entorno CLI)
• Crear estructura de tablas de la base de datos
• Ejecutar comando para generar las migraciones

Después de eso puede ejecutar esas migraciones (run) en otro entorno para crear la misma estructura de BD.

Crear fichero de configuración

<?php

use Phalcon\Config;

return new Config([
    'database' => [
        'adapter' => 'mysql',
        'host' => '127.0.0.1',
        'username' => 'root',
        'password' => '',
        'dbname' => 'db-name',
        'charset' => 'utf8',
    ],
    'application' => [
        'logInDb' => true,
        'migrationsDir' => 'db/migrations',
        'migrationsTsBased' => true, // true - Use TIMESTAMP as version name, false - use versions
        'exportDataFromTables' => [
            // Tables names
            // Attention! It will export data every new migration
        ],
    ],
]);

Generar migraciones

Generación básica

vendor/bin/phalcon-migrations generate

**Genera una tabla específica y exporta sus datos

vendor/bin/phalcon-migrations generate \
    --config=migrations.php \
    --table=users \
    --exportDataFromTables=users \
    --data=oncreate

Ejecutar migraciones

vendor/bin/phalcon-migrations run

Listar migraciones existentes

vendor/bin/phalcon-migrations list

Ejemplo de uso

Ejecutar migraciones desde directorio de migraciones específico

use Phalcon\Migrations\Migrations;

$migration = new Migrations();
$migration::run([
    'migrationsDir' => [
        __DIR__ . '/migrations',
    ],
    'config' => [
        'database' => [
            'adapter' => 'Mysql',
            'host' => 'phalcon-db-mysql',
            'username' => 'root',
            'password' => 'root',
            'dbname' => 'vokuro',
        ],
    ]
]);

Métodos de migración

Cada migración está en una clase separada que trabaja como entidad para una tabla de base de datos específica. Dentro de cada clase hay diferentes métodos que pueden ocurrir durante la ejecución de la migración.

Cada fichero de migración (y clase) puede implementar métodos específicos, que serán ejecutados según la operación solicitada. No hay restricciones sobre la lógica encapsulada en cada método.

Las tablas siguiente muestran los métodos de la Clase Migration. Se almacenan por orden de ejecución, del más antiguo al más reciente.

Ejecutándose hacia arriba

Ejecutándose hacia abajo

Argumentos y opciones CLI

Argumentos

Opciones

Migraciones basadas en marcas de tiempo

El uso de este enfoque es útil cuando más de un desarrollador está participando en la gestión de la estructura de base de datos. Use 'migrationsTsBased' => true en el fichero de configuración o la opción --ts-based en el entorno CLI. También, necesita especificar el sufijo descr, que podría ser cualquier cosa que quiera, por ejemplo: versión semántica.

Comando actual

vendor/bin/phalcon-migrations generate --ts-based --descr=1.0.0

Producirá el nombre de carpeta con tales nombres

• 1582539287636860_1.0.0
• 1682539471102635_1.0.0
• 1782539471102635_1.0.0

Las migraciones se ejecutarán de la más antigua a la más reciente.

NOTA: Cuando se ejecuten las migraciones, las aplicación escanea todas las migraciones disponibles y su estado independientemente de su “edad”. Si una o más no fueron ejecutadas en una ejecución anterior, serán ejecutadas en la siguiente ejecución.