在开发数据库驱动的应用程序的过程中,数据库结构随源代码发展。Yii提供 数据库迁移 功能,可以让您跟踪数据库更改。
Yii提供了以下迁移命令行工具 -
创建新的迁移
恢复迁移
应用迁移
重新应用迁移
显示迁移状态和历史记录
创建迁移
让我们创建一个新的数据库迁移。
第1步 - 在基本应用程序模板的项目根目录下打开控制台窗口并运行。
./yii migrate/create add_news_table
上述命令将在 migrations
文件夹中创建一个新的迁移文件(在这种情况下为m160113_102634_add_news_table.php)。
该文件包含以下代码 -
use yii\db\Schema;
use yii\db\Migration;
class m160113_102634_add_news_table extends Migration {
public function up() {
}
public function down() {
echo "m160113_102634_add_news_table cannot be reverted.\n";
return false;
}
/*
// Use safeUp/safeDown to run migration code within a transaction
public function safeUp() {
}
public function safeDown() {
}
*/
}
?>
每个数据库迁移都是一个扩展了 yii \ db \ Migration 类的PHP 类。类名称以以下格式生成 -
m_
其中 < YYMMDD_HMMSS>是执行迁移命令的UTC日期时间,是您在控制台命令中提供的参数。
在升级数据库时调用up()方法,而在降级时调用down()方法。
步骤2 - 要将新表添加到数据库,请按照这种方式修改迁移文件。
use yii\db\Schema;
use yii\db\Migration;
class m160113_102634_add_news_table extends Migration {
public function up() {
$this->createTable("news", [
"id" => Schema::TYPE_PK,
"title" => Schema::TYPE_STRING,
"content" => Schema::TYPE_TEXT,
]);
}
public function down() {
$this->dropTable('news');
}
/*
// Use safeUp/safeDown to run migration code within a transaction
public function safeUp() {
}
public function safeDown() {
}
*/
}
?>
在上面的代码中,我们在 up() 方法中创建了一个名为news的新表,并将该表放在 down() 方法中。
该 消息
表由三个字段组成:ID,标题和内容。在创建表或列时,我们应该使用抽象类型,以便迁移独立于数据库类型。例如,在MySQL的情况下,TYPE_PK将被转换为int(11)NOT
NUL AUTO_INCREMETN PRIMARY KEY。
步骤3 - 要升级数据库,请运行此命令。
./yii migrate
以上命令将列出所有尚未应用的可用迁移。然后,如果确认应用迁移,它将在所有新迁移类中运行safeUp()或up()。
第4步 - 只应用三个可用的迁移,您可以运行。
./yii migrate 3
第5步 - 您还可以定义数据库应迁移到的特定迁移。
#使用时间戳指定迁移
yii migrate/to 160202_195501
#使用可以由strtotime()分析的字符串
yii migrate/to "2016-01-01 19:55:01"
#使用全名
yii migrate/to m160202_195501_create_news_table
#使用UNIX时间戳
yii migrate/to 1393964718
第6步 - 恢复迁移(执行down()或safeDown()方法),运行。
./yii migrate/down
第7步 - 要恢复最近五次最近应用的迁移,您可以运行。
./yii migrate/down 5
第8步 - 重做(恢复,然后再次应用)迁移,运行。
./yii migrate/redo
要列出已经应用的迁移,请使用这些命令 -
yii migrate / new #显示前10个新迁移
yii migrate / new 3 #显示前3个新迁移
yii migrate / new all #显示所有新的迁移
yii migrate / history #显示最近10次应用的迁移
yii migrate / history 20 #显示最近20次应用迁移
yii migrate / history all #显示所有应用的迁移
有时您需要添加或删除特定表格中的列。您可以使用 addColumn() 和 dropColumn() 方法。
第1步 - 创建一个新的迁移。
./yii migrate/create add_category_to_news
第2步 - 以这种方式修改新创建的迁移文件。
use yii\db\Schema;
use yii\db\Migration;
class m160113_110909_add_category_to_news extends Migration {
public function up() {
$this->addColumn('news', 'category', $this->integer());
}
public function down() {
$this->dropColumn('news', 'category');
}
}
?>
现在,如果运行 ./yii migrate , 则应将 类别列添加到新闻表中。相反,如果运行 ./yii migrate / down
1 ,则应删除类别列。
执行数据库迁移时,确保每次迁移已成功或失败非常重要。建议将DB操作包含在事务中。要实现事务性迁移,您应该将迁移代码放在 safeUp() 和
safeDown() 方法中。如果这些方法中的任何操作失败,则以前的所有操作都将回滚。
前面的“交易方式”的例子是 -
use yii\db\Schema;
use yii\db\Migration;
class m160113_110909_add_category_to_news extends Migration {
public function safeUp() {
$this->addColumn('news', 'category', $this->integer());
}
public function safeDown() {
$this->dropColumn('news', 'category');
}
}
?>
所述 YII \分贝\迁移 类提供用于操纵数据库下列方法-
execute() - 执行原始SQL语句
createTable() - 创建一个表
renameTable() - 重命名表
insert() - 插入单行
batchInsert() - 插入多行
update() - 更新行
删除() - 删除行
addColumn() - 添加一列
renameColumn() - 重命名一列
dropColumn() - 删除一列
alterColumn() - 改变列
dropTable() - 删除一个表
truncateTable() - 删除表中的所有行
createIndex() - 创建一个索引
dropIndex() - 删除索引
addPrimaryKey() - 添加主键
dropPrimaryKey() - 删除主键
addForeignKey() - 添加一个外键
dropForeignKey() - 删除外键