テーブルを作成する

// ... public function up() { $columns = array( 'id' => array( 'type'

=> 'integer', 'unsigned' => 1, 'notnull' => 1, 'default' => 0 ), 'name' => array( 'type' => 'string', 'length' => 12 ), 'password' => array( 'type' => 'string', 'length' => 12 ) );

    $options = array(
        'type'     => 'INNODB',
        'charset'  => 'utf8'
    );

    $this->createTable('table_name', $columns, $options);
}

// ...

NOTE スキーマを操作するために使われるデータ構造とデータベース抽象化レイヤーで使われるデータ構造が同じであることにお気づきかもしれません。これはマイグレーションクラスで指定されているオペレーションを実行するために内部でマイグレーションパッケージがデータベース抽象化レイヤーを使用しているからです。

テーブルを削除する

// ... public function down() { $this->dropTable('table_name'); } //

...

テーブルをリネームする

// ... public function up() { $this->renameTable('old_table_name',

'new_table_name'); } // ...

制約を作成する

// ... public function up() { $definition = array( 'fields' => array(

'username' => array() ), 'unique' => true );

    $this->createConstraint('table_name', 'constraint_name', $definition);
}

// ...

制約を削除する

Now the opposite ``down()`` would look like the following:

// ... public function down() { $this->dropConstraint('table_name',

'constraint_name'); } // ...

外部キーを削除する

// ... public function up() { $definition = array( 'local' =>

'email_id', 'foreign' => 'id', 'foreignTable' => 'email', 'onDelete' => 'CASCADE' );

    $this->createForeignKey('table_name', 'email_foreign_key', $definition);
}

// ...

$definition用の有効なオプションは次の通りです:

||  名前 ||  説明 || || name || オプションの制約名 || || local || ローカルフィールド || || foreign || 外部参照フィールド || || foreignTable || 外部テーブルの名前 || || onDelete || 参照の削除アクション || || onUpdate || 参照の更新アクション || || deferred || 延期された制約チェック ||

外部キーを削除する

// ... public function down() { $this->dropForeignKey('table_name',

'email_foreign_key'); } // ...

カラムを追加する

// ... public function up() { $this->addColumn('table_name',

'column_name', 'string', $length, $options); } // ...

カラムをリネームする

NOTE sqliteのような一部のDBMSはカラムのリネームオペレーションを実装していません。sqlite接続を使用している場合カラムをリネームしようとすると例外が投げられます。

// ... public function up() { $this->renameColumn('table_name', 'old_column_name', 'new_column_name'); } // ...

カラムを変更する

既存のカラムのアスペクトを変更する:

// ... public function up() { $options = array('length' => 1);

$this->changeColumn('table_name', 'column_name', 'tinyint', $options); } // ...

カラムを削除する

// ... public function up() { $this->removeColumn('table_name',

'column_name'); } // ...

不可逆なマイグレーション

Doctrine_Migration_IrreversibleMigrationException( 'The remove column operation cannot be undone!' ); } // ...

インデックスを追加する

// ... public function up() { $options = array('fields' => array(

'username' => array( 'sorting' => 'ascending' ), 'last_login' => array()));

    $this->addIndex('table_name', 'index_name', $options)
}

// ...

インデックスを削除する

// ... public function down() { $this->removeIndex('table_name',

'index_name'); } // ...

データベースから

既存のデータベース接続からマイグレーションのセットを生成するには、Doctrine_Core::generateMigrationsFromDb()を使います。

Doctrine_Core::generateMigrationsFromDb('/path/to/migration/classes');

既存のモデルから

既存のモデルのセットからマイグレーションのセットを生成するには、Doctrine_Core::generateMigrationsFromModels()を使うだけです。

Doctrine_Core::generateMigrationsFromModels('/path/to/migration/classes', '/path/to/models');

差分ツール

ときにはモデルを変更して変更に対するマイグレーション処理を自動化できるようにしたいことがあります。以前は変更に対してマイグレーションクラスを書かなければなりませんでした。しかし差分ツールによって変更を行い変更用のマイグレーションクラスを生成できます。

差分ツールはシンプルで使いやすいです。これは"from"と"to"を受け取り、これらは次のうちのどれかになります:

• YAMLスキーマファイルへのパス
• 既存のデータベース接続の名前
• モデルの既存のセットへのパス

2つのYAMLスキーマファイルを作るシンプルな例を考えます。1つはschema1.ymlでもう1つはschema2.ymlという名前です。

schema1.ymlはシンプルなUserモデルを含みます:

# schema1.yml

User: columns: username: string(255) password: string(255)

スキーマを修正してemail_addressカラムを追加する場合を考えてみましょう:

# schema1.yml

User: columns: username: string(255) password: string(255) email_address: string(255)

これでデータベースに新しいカラムを追加できるマイグレーションクラスを簡単に作ることができます:

Doctrine_Core::generateMigrationsFromDiff('/path/to/migration/classes', '/path/to/schema1.yml', '/path/to/schema2.yml');

これによって/path/to/migration/classes/1236199329_version1.phpのパスでファイルが生み出されます。

class Version1 extends Doctrine_Migration_Base { public function up()

{ $this->addColumn('user', 'email_address', 'string', '255', array ()); }

public function down()
{
    $this->removeColumn('user', 'email_address');
}

}

データベースを簡単にマイグレートして新しいカラムを追加できます！