naxel/zfctool

Utility module for ZFCore2

dev-master 2015-04-01 13:39 UTC

This package is not auto-updated.

Last update: 2024-04-13 13:30:53 UTC


README

То что тесты проходят успешно это ещё ни о чем не говорит (c)

Build Status

Dependency Status

Latest Stable Version Total Downloads Latest Unstable Version License

Coverage Status

ZFCTool - Zend Framework 2 command line Tool

###Установка:

Добавляем в composer.json:

{
    "require-dev": {
        "zfstarter/zfs-tool": "dev-master"
    }
}

И обновляем зависимость:

$ curl -s http://getcomposer.org/installer | php
$ php composer.phar update

В config\autoload\global.php

указываем, если нужно, директорию где находятся модули, как будет называться директория с миграциямии и таблица в БД:

// Указать массивом список директорий
'ZFCTool' => array(
        'migrations' => array(
            'modulesDirectoryPath' => array(
                'module',
                'vendor/zfstarter'
            )
        )
    )

// Либо строкой
'ZFCTool' => array(
        'migrations' => array(
            'modulesDirectoryPath' => 'module'
        )
    )

###Работа с миграциями:

###Пример работы с миграциями:

####Создание миграции Если необходимо сгенерировать миграцию для определенного модуля, когда под него таблица в БД уже создана:

php vendor/bin/zfc.php gen migration --module=Pages --whitelist=pages -c

при этом указываем имя модуля (регистр важен), а также имя нужной таблицы задаем в "whitelist", если не хотите добавлять лишнии таблици в миграцию, сразу же комитем эту миграцию, для этого параметр "-c"

####Применение миграции

Если при апдейте кода к вам "пришла" новая миграция, то чтобы обновить БД вам нжно выполнить всего одну команду:

php vendor/bin/zfc.php up db [-i]

если не указывать дополнительных параметров, то применяться все существующие миграции. -i - (Опциональный) применить миграции всех модулей, включая корневые миграции

####Список всех миграций

  ~$ php vendor/bin/zfc.php ls migrations [--module]
  ~$ php vendor/bin/zfc.php ls migrations [-i]

module - (Опциональный) вывести только миграции указанного модуля -i - (Опциональный) вывести миграции всех модулей, включая корневые

####Обновить БД к указанной миграции

  ~$ php vendor/bin/zfc.php up db <to> [--module]
  ~$ php vendor/bin/zfc.php up db <to> [-i]

module - (Опциональный) название модуля, к которому будет применяться (если не указан, то применяеться ко всем миграциям) -i - (Опциональный) поиск миграции по всем модулям, включая корневые миграции to - (Опциональный) имя миграции к которой обновить (если не указан, то обновить к последней)

####Откатить миграции все мигрции до указанной, включая её

  ~$ php vendor/bin/zfc.php down db <to> [--module]
  ~$ php vendor/bin/zfc.php down db <to> [-i]

module - (Опциональный) название модуля, к которому будет применяться (если не указан, то применяеться ко всем миграциям) -i - (Опциональный) поиск миграции по всем модулям, включая корневые миграции to - (Опциональный) имя миграции, которую откатить (если не указан, то откатить все)

####Показать текущую миграцию

  ~$ php vendor/bin/zfc.php show migration

####Сгенерировать миграцию

  ~$ php vendor/bin/zfc.php gen migration [--module] [--whitelist] [--blacklist] [-c] [-e]

module - (Опциональный) название модуля, для которого сгенерируеться миграция

module - (Опциональный) название модуля, для которого сгенерируеться миграция whitelist - (Опциональный) список таблиц, для которых генерить blacklist - (Опциональный) список таблиц исключения c - (Опциональный) сразу же после создания применить миграцию e - (Опциональный) создать пустой шаблон миграции

####Принудительное применение миграции

  ~$ php vendor/bin/zfc.php ci migration <to> [--module]
  ~$ php vendor/bin/zfc.php ci migration <to> [-i]

module - (Опциональный) название модуля, где находиться миграция -i - (Опциональный) поиск миграции по всем модулям, включая корневые миграции to - имя миграции, которую следует применить

####Откат мигрций

  ~$ php vendor/bin/zfc.php back db [--module] [--step]
  ~$ php vendor/bin/zfc.php back db [-i] [--step]

module - (Опциональный) название модуля -i - (Опциональный) поиск миграции по всем модулям, включая корневые миграции step - (Опциональный) количество откатываемых миграций

####Показать различие в стрцктуре БД между последним обновлением и текущим состоянием

  ~$ php vendor/bin/zfc.php diff db [--module] [--whitelist] [--blacklist]

module - (Опциональный) название модуля, для которого сгенерируеться миграция whitelist - (Опциональный) список таблиц, для которых генерить blacklist - (Опциональный) список таблиц исключения

###Работа с дампом БД:

####Список всех дампов

  ~$ php vendor/bin/zfc.php ls dump [-i]

-i - (Опциональный) вывести дампы всех модулей, включая корневые

####Создание дампа БД:

  ~$ php vendor/bin/zfc.php create dump [--module] [--name] [--whitelist] [--blacklist]

name - (Опциональный) имя дампа module - (Опциональный) название модуля, для которого сгенерируеться дамп whitelist - (Опциональный) список таблиц, для которых генерить blacklist - (Опциональный) список таблиц исключения

####Импорт дампа БД:

  ~$ php vendor/bin/zfc.php import dump <name> [--module]

module - (Опциональный) название модуля, для которого сгенерируеться дамп name - (Опциональный) имя дампа

Support

If you believe you have found a bug, please report it using the GitHub issue tracker, or better yet, fork the library and submit a pull request.