magnifico/bitrix-phinx

bitrix-phinx

Как поставить

1. Ставим пакет через composer

composer require magnifico/bitrix-phinx:^0.1

1. Ставим симлинк с именем "magnifico.phinx" из директории bitrix'а на местоположение пакета, например:

cd /home/bitrix/www/bitrix/modules
ln -s ../../../vendor/magnifico/bitrix-phinx magnifico.phinx

1. Делаем то же самое для модуля "magnifico.console":

cd /home/bitrix/www/bitrix/modules
ln -s ../../../vendor/magnifico/bitrix-console magnifico.console

1. Устанавливаем оба модуля в админке битрикса, _(*1)

2. Создаем где-нибудь файл "manage.php":, _(*2)

<?php

# Определяем, где находится DOCUMENT_ROOT
$_SERVER['DOCUMENT_ROOT'] = '/home/bitrix/www';

# Включаем служебный скрипт из модуля magnifico.console
require_once $_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/magnifico.console/manage.php';

1. Пользуемся

Как работать с модулем

Никакого дополнительного конфигурирования (типа phinx.yml) - не требуется, все необходимые настройки считываются из ядра битрикса., _(*3)

В отличие от оригинального phinx'а, у каждой команды первым обязательным аргументом добавлено имя модуля битрикса, к которому относятся миграции. Все остальные параметры остались без изменений., _(*4)

Например, если наш модуль называется magnifico.site, команды будут выглядеть так:, _(*5)

# Создать миграцию
php manage.php phinx:create magnifico.site MigrationName

# Применение миграций
php manage.php phinx:migrate magnifico.site

# Откат миграций
php manage.php phinx:rollback magnifico.site

# Информация о миграциях
php manage.php phinx:status magnifico.site

Миграции при этом будут создаваться и искаться в директории "migrations", лежащей в директории соответствующего модуля, например:, _(*6)

# Если используется local
/home/bitrix/www/local/modules/magnifico.site/migrations

# Так тоже будет работать
/home/bitrix/www/bitrix/modules/magnifico.site/migrations

Также, в отличие от оригинального phinx'а, в базе данных будет создана не одна таблица, а по таблице на каждый отдельный модуль по паттерну "magnifico_phinx_migrations_of_{module_name}", например:, _(*7)

magnifico_phinx_migrations_of_magnifico_site
magnifico_phinx_migrations_of_atlaslib_feedback

Применение миграций для нескольких модулей

php manage.php phinx:migrate magnifico.site1 magnifico.site2 magnifico.site3, _(*8)

Применение миграций для всех модулей

php manage.php phinx:migrate, _(*9)

При применении миграций для более чем одного модуля, миграции для каждого модуля запускаются в отдельном процессе. Это делается для того чтобы не возникло повторного объявления php класса в случае когда в разных модулях есть миграции с одинаковыми именами. Для запуска отдельного процесса используются следующие переменные окужения: - php_bin - путь к исполняемому файлу php, по умолчанию PHP_BINARY - manager_file - путь к файлу manage.php, по умолчанию realpath($_SERVER['argv'][0]), _(*10)

При необходимости вы можете задать эти переменные следующим образом., _(*11)

\Bitrix\Main\Config\Option::set('magnifico.phinx', 'php_bin', '/bin/php');
\Bitrix\Main\Config\Option::set('magnifico.phinx', 'manager_file', '/app/www/manager.php');