Міграції бази даних

NOTE: Phalcon migrations have been removed from DevTools and moved to a separate repository.

Git репозиторій

https://github.com/phalcon/migrations

Вимоги

• PHP >= 7.5
• Phalcon >= 5.0.0

Встановлення за допомогою Composer

composer require --dev phalcon/migrations

Швидкий старт

Що вам потрібно для швидкого старту:

• Файл конфігурації в кореневому каталозі вашого проекту (ви також можете передати їх як параметри в середовищі CLI)
• Створення структури таблиць бази даних
• Виконайте команду для створення міграцій

Після цього ви зможете виконати цю міграцію (run) в іншому середовищі для створення такої ж структури БД.

Створюємо файл конфігурації

<?php

use Phalcon\Config\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',
        // true - TIMESTAMP, false - versions
        'migrationsTsBased'    => true, 
        'exportDataFromTables' => [
            // Tables names
        ],
    ],
]);

NOTE: If exportDataFromTables is set, data will be exported with every migration

Генерування міграцій

Базова генерація

vendor/bin/phalcon-migrations generate

**Згенеруйте спеціальну таблицю і експортуйте з неї дані

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

Запуск міграції

vendor/bin/phalcon-migrations run

Список існуючих міграцій

vendor/bin/phalcon-migrations list

Приклад використання

Запустити міграції з каталогу міграцій

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',
        ],
    ]
]);

Методи міграції

Each migration is a separate class that works as an entity for specific database table. Всередині кожного класу є різні методи, які можуть виконуватися під час роботи міграції.

Кожен файл міграції (та клас) може реалізувати конкретні методи, які будуть виконані на основі запитаної операції. У кожному методі немає жодних обмежень за логікою.

Таблиця нижче показує методи міграції. Вони зберігаються в порядку виконання, від перших до останніх.

Працює догори

Працює донизу

Параметри і опції CLI

Аргументи

Options

Версія міграції на основі часових позначок

Використання цього підходу корисне, коли більше одного розробника бере участь в управлінні структурою бази даних. Використовуйте параметр 'migrationsTsBased' => true у файлі конфігурації або --ts-based в середовищі CLI. Крім того, необхідно вказати суфікс descr, це може бути що завгодно, наприклад: семантичні версії.

Поточна команда

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

Створить назву теки з такими іменами

* 1582539287636860_1.0.0
* 1682539471102635_1.0.0
* 1782539471102635_1.0.0

Міграції будуть виконані від старіших до новіших.

NOTE: Whenever migrations are run, the application scans all available migrations and their status irrespective of their “age”. Якщо одна чи кілька не були виконані попереднього разу, вони будуть виконані наступного разу.