Remarque : Yii ne prend en charge la fonctionnalité de migration de base de données qu'à partir de la version 1.1.6.
Comme le code source, la structure de la base de données continue de croître à mesure que nous développons et maintenons des applications basées sur la base de données. Par exemple, pendant le développement, nous pouvons souhaiter ajouter une nouvelle table ou après la mise en place de l'application ; en production, nous pouvons réaliser que nous devons ajouter un index sur une certaine colonne. Le suivi de ces modifications dans la structure de la base de données (appelées migrations) est aussi important que l'exploitation du code source. Si le code source et la base de données sont désynchronisés, le système peut être interrompu. C'est pour cette raison que le framework Yii fournit des outils de migration de bases de données afin de suivre l'historique des migrations de bases de données, d'appliquer de nouvelles migrations ou de restaurer d'anciennes migrations
Les étapes suivantes montrent comment utiliser les migrations de bases de données pendant le développement : Tim ajoute une nouvelle migration (par exemple créer une nouvelle table)
Tim soumet une nouvelle migration à l'outil de contrôle de version (par exemple SVN, GIT)
Doug met à jour et supprime une nouvelle migration de l'outil de contrôle de version
Doug applique de nouvelles migrations à la version de développement local de la base de données
yiic migrate create <name>
yiic migrate create create_news_table
class m101129_185401_create_news_table extends CDbMigration
{
public function up(){}
public function down()
{
echo "m101129_185401_create_news_table does not support migration down.\n";
return false;
}
/*
// implement safeUp/safeDown instead if transaction is needed
public function safeUp(){}
public function safeDown(){}
*/
}down() renvoie false pour indiquer que la migration est irréversible.
Info : À partir de la version 1.1.7, si la méthode up() ou down() renvoie false, toutes les migrations ci-dessous seront annulées. Dans la version 1.1.6, une exception doit être levée pour annuler la migration suivante. Utilisons un exemple pour montrer la migration de la création d'une table d'actualitésclass m101129_185401_create_news_table extends CDbMigration
{
public function up()
{
$this->createTable('tbl_news', array(
'id' => 'pk',
'title' => 'string NOT NULL',
'content' => 'text',
));
}
public function down()
{
$this->dropTable('tbl_news');
}
}public function up()
{
$sql = "CREATE TABLE IF NOT EXISTS user(
id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(32) NOT NULL,
password VARCHAR(32) NOT NULL,
email VARCHAR(32) NOT NULL
) ENGINE=MyISAM";
$this->createTableBySql('user',$sql);
}
public function createTableBySql($table,$sql){
echo " > create table $table ...";
$time=microtime(true);
$this->getDbConnection()->createCommand($sql)->execute();
echo " done (time: ".sprintf('%.3f', microtime(true)-$time)."s)\n";
}class m101129_185401_create_news_table extends CDbMigration
{
public function up()
{
$transaction=$this->getDbConnection()->beginTransaction();
try
{
$this->createTable('tbl_news', array(
'id' => 'pk',
'title' => 'string NOT NULL',
'content' => 'text',
));
$transaction->commit();
}catch(Exception $e){
echo "Exception: ".$e->getMessage()."\n";
$transaction->rollback();
return false;
}
}
// ...similar code for down()
}class m101129_185401_create_news_table extends CDbMigration
{
public function safeUp()
{
$this->createTable('tbl_news', array(
'id' => 'pk',
'title' => 'string NOT NULL',
'content' => 'text',
));
}
public function safeDown()
{
$this->dropTable('tbl_news');
}
}<.>3. Utiliser les migrations
yiic migrate
这个命令会显示所有新迁移的列表. 如果你确定使用迁移, 它将会在每一个新的迁移类中运行up()方法, 一个接着一个, 按照类名中的时间戳的顺序.
在使用迁移之后, 迁移工具会在一个数据表tbl_migration中写一条记录——允许工具识别应用了哪一个迁移. 如果tbl_migration表不存在 ，工具会在配置文件中db指定的数据库中自动创建。
有时候, 我们可能指向应用一条或者几条迁移. 那么可以运行如下命令:
yiic migrate up 3
这个命令会运行3个新的迁移. 该表value的值3将允许我们改变将要被应用的迁移的数目。
我们还可以通过如下命令迁移数据库到一个指定的版本:
yiic migrate to 101129_185401
也就是我们使用数据库迁移名中的时间戳部分来指定我们想要迁移到的数据库的版本。如果在最后应用的数据库迁移和指定的迁移之间有多个迁移, 所有这些迁移都会被应用. 如果指定迁移已经使用过了, 所有之后应用的迁移都会恢复。
想要恢复最后一个或几个已应用的迁移，我们可以运行如下命令：
yiic migrate down [step]
其中选项 step 参数指定了要恢复的迁移的数目. 默认是1, 意味着恢复最后一个应用的迁移.
正如我们之前所描述的, 不是所有的迁移都能恢复. 尝试恢复这种迁移会抛出异常并停止整个恢复进程。
重做迁移意味着第一次恢复并且之后应用指定的迁移. 这个可以通过如下命令来实现:
yiic migrate redo [step]
其中可选的step参数指定了重做多少个迁移 . 默认是1, 意味着重做最后一个迁移.
除了应用和恢复迁移之外, 迁移工具还可以显示迁移历史和被应用的新迁移。
yiic migrate history [limit] yiic migrate new [limit]
其中可选的参数 limit 指定克显示的迁移的数目。如果limit没有被指定，所有的有效迁移都会被显示。
第一个命令显示已经被应用的迁移, 而第二个命令显示还没被应用的迁移。
有时候, 我们可能想要在没有应用和恢复相应迁移的时候编辑迁移历史来指定迁移版本. 这通常发生在开发一个新的迁移的时候. 我们使用下面的命令来实现这一目标.
yiic migrate mark 101129_185401
这个命令和yiic migrate to命令非常类似, 但它仅仅只是编辑迁移历史表到指定版本而没有应用或者恢复迁移。
有多种方式来自定义迁移命令。
使用命令行选项
迁移命令需要在命令行中指定四个选项:
interactive: boolean, specifies whether to perform migrations in an interactive mode. Defaults to true, meaning the user will be prompted when performing a
specific migration. You may set this to false should the migrations be done in a background process.
migrationPath: string, specifies the directory storing all migration class files. This must be specified in terms of a path alias, and the corresponding
directory must exist. If not specified, it will use the migrations sub-directory under the application base path.
migrationTable: string, specifies the name of the database table for storing migration history information. It defaults to tbl_migration. The table
structure is version varchar(255) primary key, apply_time integer.
connectionID: string, specifies the ID of the database application component. Defaults to 'db'.
templateFile: string, specifies the path of the file to be served as the code template for generating the migration classes. This must be specified in terms of a
path alias (e.g. application.migrations.template). If not set, an internal template will be used. Inside the template, the token {ClassName} will be replaced
with the actual migration class name.想要指定这些选项, 使用如下格式的迁移命令执行即可：
yiic migrate up --option1=value1 --option2=value2 ...
例如, 如果我们想要迁移一个论坛模块，它的迁移文件都放在模块的迁移文件夹中，可以使用如下命令:
yiic migrate up --migrationPath=ext.forum.migrations
注意在你设置布尔选项如interactive的时候，使用如下方式传入1或者0到命令行:
yiic migrate --interactive=0
配置全局命令
命令行选项允许我们快速配置迁移命令, 但有时候我们可能想要只配置一次命令. 例如, 我们可能想要使用不同的表来保存迁移历史, 或者我们想要使用自定义的迁移模板。我们可以通过编辑控制台应用的配置文件来实现，如下所示:
return array( ...... 'commandMap'=>array( 'migrate'=>array( 'class'=>'system.cli.commands.MigrateCommand', 'migrationPath'=>'application.migrations', 'migrationTable'=>'tbl_migration', 'connectionID'=>'db', 'templateFile'=>'application.migrations.template', ), ...... ), ...... );
现在如果我们运行迁移命令，上述配置将会生效，而不需要我们每一次在命令行中都输入那么多选项信息。
以上就是Yii框架官方指南系列增补版27——使用数据库：数据库迁移的内容，更多相关内容请关注PHP中文网（www.php.cn）！
Comment télécharger le panneau de configuration nvidia
bootmgr est manquant et ne peut pas démarrer
Qu'est-ce que la blockchain web3.0
Racine du téléphone portable
Comment exporter Word à l'aide de PowerDesigner
Comment changer la couleur du pinceau PS
tutoriel de flexibilité
Comment changer les paramètres entre les systèmes doubles Huawei
![[Web front-end] Démarrage rapide de Node.js](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
