andreyryabin / sprint.migration
bitrix migration module
Fund package maintenance!
yoomoney.ru/to/410012104240288
Installs: 110 762
Dependents: 2
Suggesters: 0
Security: 0
Stars: 160
Watchers: 17
Forks: 53
Open Issues: 17
Type:bitrix-module
Requires
- php: >=7.0
- ext-iconv: *
- ext-json: *
- composer/installers: ~1
- dev-master
- 4.6.1
- 4.4.1
- 4.3.2
- 4.3.1
- 4.2.5
- 4.2.4
- 4.2.2
- 4.2.1
- 4.1.3
- 4.1.2
- 4.1.1
- 4.0.6
- 4.0.5
- 4.0.4
- 4.0.3
- 4.0.2
- 4.0.1
- 4.0.0
- 3.30.1
- 3.29.5
- 3.29.4
- 3.29.3
- 3.29.2
- 3.29.1
- 3.28.8
- 3.28.7
- 3.28.6
- 3.28.5
- 3.28.4
- 3.28.3
- 3.28.2
- 3.28.1
- 3.27.1
- 3.26.1
- 3.25.1
- 3.24.1
- 3.23.4
- 3.22.4
- 3.22.3
- 3.22.2
- 3.22.1
- 3.21.4
- 3.21.3
- 3.21.2
- 3.21.1
- 3.20.4
- 3.20.2
- 3.20.1
- 3.19.1
- 3.18.1
- 3.17.3
- 3.17.2
- 3.17.1
- 3.16.3
- 3.16.2
- 3.16.1
- 3.15.1
- 3.14.6
- 3.14.5
- 3.14.4
- 3.14.3
- 3.13.5
- 3.13.4
- 3.13.3
- 3.13.2
- 3.13.1
- 3.12.19
- 3.12.18
- 3.12.17
- 3.12.16
- 3.12.15
- 3.12.14
- 3.12.12
- 3.12.10
- 3.12.9
- 3.12.8
- 3.12.7
- 3.12.6
- 3.12.5
- 3.12.4
- 3.12.3
- 3.12.2
- 3.12.1
- 3.11.1
- 3.10.2
- 3.10.1
- 3.9.3
- 3.9.2
- 3.9.1
- 3.8.6
- 3.8.5
- 3.8.4
- 3.8.3
- 3.8.2
- 3.8.1
- 3.7.3
- 3.7.2
- 3.7.1
- 3.6.9
- 3.6.8
- 3.6.7
- 3.6.6
- 3.6.5
- 3.6.4
- 3.6.3
- 3.6.2
- 3.6.1
- 3.5.6
- 3.5.5
- 3.5.4
- 3.5.3
- 3.5.2
- 3.5.1
- 3.4.7
- 3.4.6
- 3.4.5
- 3.4.4
- 3.4.3
- 3.4.2
- 3.4.1
- 3.3.8
- 3.3.7
- 3.3.6
- 3.3.5
- 3.3.4
- 3.3.3
- 3.3.2
- 3.3.1
- 3.2.1
- 3.1.3
- 3.1.2
- 3.1.1
- 3.0.18
- 3.0.17
- 3.0.16
- 3.0.15
- 3.0.14
- 3.0.12
- 3.0.11
- 3.0.9
- 3.0.8
- 3.0.7
- 3.0.6
- 3.0.5
- 3.0.4
- 3.0.0
- 2.8.21
- 2.8.19
- 2.8.18
- 2.8.17
- 2.8.16
- 2.8.15
- 2.8.14
- 2.8.12
- 2.8.11
- 2.8.9
- 2.8.8
- 2.8.7
- 2.8.6
- 2.8.5
- 2.8.4
- 2.8.3
- 2.8.2
- 2.8.1
- 2.7.5
- 2.7.4
- 2.7.3
- 2.7.2
- 2.7.1
- 2.6.2
- 2.6.1
- 2.5.11
- 2.5.8
- 2.5.7
- 2.5.6
- 2.5.5
- 2.5.4
- 2.5.3
- 2.5.2
- 2.5.1
- 2.4.5
- 2.4.4
- 2.4.3
- 2.4.2
- 2.4.1
- 2.3.11
- 2.3.9
- 2.3.8
- 2.3.7
- 2.3.6
- 2.3.5
- 2.3.4
- 2.3.3
- 2.3.2
- 2.3.1
- 2.2.12
- 2.2.11
- 2.2.9
- 2.2.8
- 2.2.7
- 2.2.6
- 2.2.5
- 2.2.4
- 2.2.3
- 2.2.2
- dev-release-4.1.1
- dev-release-4.1.0
- dev-medialib
- dev-release-3.15.1
This package is auto-updated.
Last update: 2023-11-23 20:29:40 UTC
README
Помогает переносить изменения между нескольким копиями проекта.
Все изменения для базы данных пишутся в файлы миграций, эти файлы, как и весь код проекта, хранятся в системе контроля версий (например git) и попадают в копии разработчиков, после чего им необходимо выполнить установку новых миграций, чтобы обновить бд.
Работать можно как через консоль, так и через админку.
- Маркетплейс: http://marketplace.1c-bitrix.ru/solutions/sprint.migration/
- Composer: https://packagist.org/packages/andreyryabin/sprint.migration
- Документация: https://github.com/andreyryabin/sprint.migration/wiki
- Материалы: https://dev.1c-bitrix.ru/community/webdev/user/39653/blog/
- Группа в телеграм: https://t.me/sprint_migration_bitrix
Особая благодарность
А также всем помощникам!
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;
}
Пример без регистрации бандла, только команды в symfony/console
// bin/console
use Sprint\Migration\SymfonyBundle\Command\ConsoleCommand;
use Symfony\Component\Console\Application;
$app = new Application();
$app->add(new ConsoleCommand());
$app->run();
Классы модуля должны уже быть автозагружены, через 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