andreyryabin/sprint.migration

bitrix migration module

Installs: 46 620

Dependents: 7

Suggesters: 0

Security: 0

Stars: 108

Watchers: 15

Forks: 40

Open Issues: 7

Type:bitrix-module

3.29.3 2021-09-24 09:53 UTC

README

Latest Stable Version Total Downloads

Помогает переносить изменения между нескольким копиями проекта.

Все изменения для базы данных пишутся в файлы миграций, эти файлы, как и весь код проекта, хранятся в системе контроля версий (например git) и попадают в копии разработчиков, после чего им необходимо выполнить установку новых миграций, чтобы обновить бд.

Работать можно как через консоль, так и через админку.

Особая благодарность

Самой лучшей IDE на свете!
Phpstorm

А также всем помощникам!
https://github.com/andreyryabin/sprint.migration/blob/master/contributors.txt

Установка через composer

Пример вашего composer.json с установкой модуля в local/modules/

{
  "extra": {
    "installer-paths": {
      "local/modules/{$name}/": ["type:bitrix-module"]
    }
  },
  "require": {
    "andreyryabin/sprint.migration": "dev-master"
  },
}

Консоль

Для работы через консоль используется скрипт /bitrix/modules/sprint.migration/tools/migrate.php

Можно запускать его напрямую или сделать алиас, создав файл в корне проекта, bin/migrate и прописав в нем:

#!/usr/bin/env php
<?php

$_SERVER['DOCUMENT_ROOT'] = dirname(__DIR__);
require_once $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/sprint.migration/tools/migrate.php';

Консоль symfony

Если у вас используется связка bitrix + symfony, то можно подключить модуль как бандл симфони и запускать консольные команды модуля через

php bin/console sprint:migration

Пример регистрации модуля:

// app/AppKernel.php
use Sprint\Migration\SymfonyBundle\SprintMigrationBundle;

public function registerBundles()
{
    $bundles = array(
        new SprintMigrationBundle(),
    );
    return $bundles;
}

Классы модуля должны уже быть автозагружены, через CModule::IncludeModule('sprint.migration')

Или через библиотеку https://packagist.org/packages/webarchitect609/bitrix-neverinclude (рекомендую этот вариант)

Примеры команд

  • php bin/migrate add (создать новую миграцию)
  • php bin/migrate ls (показать список миграций )
  • php bin/migrate up (накатить все миграции)
  • php bin/migrate up [version] (накатить выбранную миграцию)
  • php bin/migrate down (откатить все миграции)
  • php bin/migrate down [version] (откатить выбранную миграцию)

Все команды: https://github.com/andreyryabin/sprint.migration/blob/master/commands.txt

Скриншоты

Админка миграций bitrix-sprint-migration-1.png

Формы создания миграций bitrix-sprint-migration-2.png