insolita/yii2-migration-generator Set of gii tools for generating files for migration by schema of table , phpdoc or table data


Migration Generator

Latest Stable Version Total Downloads License

  • generate migration files (not dumps!) with indexes, and foreign keys, for one table, comma separated list of tables, by part of table name, for all tables by
  • generate migrations based on table data - in two ways - as batchInsert Query or as insert via model
  • generate migrations based on PHPDOC and model properties



NOTE : Use 2.x versions for yii <=2.0.13

The preferred way to install this extension is through composer.

Either run

composer require --dev --prefer-dist insolita/yii2-migration-generator:~3.1

or add

"insolita/yii2-migration-generator": "~3.1"

to the require-dev section of your composer.json file.

Just install, go to gii and use (By default composer bootstrap hook)


In general the syntax of column definitions is based on style of yii-migration, only separated by "|" and provide a little more opportunities for reducing code

  • as you see in examples - empty brackets not necessary
  • also shortcut expr() will be replaced to defaultExpression() and default() to defaultValue

You can add annotations in your model(not necessary AR or yii\base\Model or Object or stdClass)

@db (db2) - specify connection id required for migration 'db' - by default"

@table ({{%my_table}})- specify table for migration"

Supported column annotations:

  • As separate annotation above class or above current variable

  • @column (name) string|notNull|default('SomeValue') */

  • As addition to @property or @var definition

     * @var int $id @column pk()
    public $id;
     * @var string $route @column string(100)|notNull()
    public $route;
 * @property integer    $id         @column pk|comment("Id")
 * @property string     $username   @column string(100)|unique|notNull|default("Vasya")
 * @property string     $email      @column string(200)|unique()|defaultValue("")
 * @property string     $password   @column string(200)|notNull|expr(null)
 * @property string     $created_at @column string(200)|notNull|expr('CURRENT_TIMESTAMP')
class TestModel extends ActiveRecord{


Use Own templates

Copy default templates from folders

vendor/insolita/yii2-migration-generator/gii/default_structure //schema migrations

vendor/insolita/yii2-migration-generator/gii/default_data //data migrations

to some project directory, for example



Change gii configuration like this

$config['modules']['gii'] = [
    'class' => 'yii\gii\Module',
    'allowedIPs' => ['', 'localhost', '::1'],
    'generators' => [
        'migrik' => [
            'class' => \insolita\migrik\gii\StructureGenerator::class,
            'templates' => [
                'custom' => '@backend/gii/templates/migrator_schema',
        'migrikdata' => [
            'class' => \insolita\migrik\gii\DataGenerator::class,
            'templates' => [
                'custom' => '@backend/gii/templates/migrator_data',
Use own resolver for definition of columns
  • create new class, inherited from \insolita\migrik\resolver*ColumnResolver
    • override required methods, or create methods for exclusive columns based on database types - see insolita\migrik\resolver\BaseColumnResolver resolveColumn() phpdoc and realization
Use own resolver for definition of indexes or relations
  • create new class, inherited from \insolita\migrik\resolver\TableResolver
  • in bootsrap your apps add injection

    \Yii::$container->set(IMigrationTableResolver::class, YourTableResolver::class);



20.12.2018 - 3.1 improve postgres jsonb support; check on latest yii2 version

15.08.2018 - 3.0 version release; For yii >=2.0.14; add tinyInteger column support

29.04.2017 - 2.3 version release; Fix common bugs; seprate postgresql resolver for suppor arrays (one dimensional only) and json columns; fix view files;

03.02.2017 - 2.2.9 version release

  • Fix bug #28; upgrade tests for using YII2 codeception module fix #26

22.12.2016 - 2.2.7 version release

  • add fields for setup default values onUpdate and onDelete in relations

17.12.2016 - 2.2.6 version release

  • merge pr from shirase that fix issue with non-correct gii preview;

20.08.2016 - 2.2 version release

15.08.2016 - 2.1 version release

  • added ability to generate migrations in fluent interface (raw format also available)
  • improved templates; added database initializations
  • improved postresql index retrieving
  • structure improved; separate logic in external classes
  • added ability to set custom class for column generation (@see Customizing section)

13.08.2016 - 2.0 version release with new ability

  • generate migrations based on table data Possible BC
  • class insolita\migrik\gii\Generator was changed on insolita\migrik\gii\StructureGenerator if you made template customizations - see your gii config and replace old Generator class name


GitHub Stars
GitHub Forks



3.2 is the latest of 19 releases

MIT license
106 github stars & 29 github forks
7 downloads in the last day
2448 downloads in the last 30 days
346909 total downloads