Yii框架中的数据库迁移脚本管理

Yii框架是一个高性能的PHP框架，用于开发Web 2.0应用。在Yii中，数据库迁移是一种强大的工具，用于管理数据库结构的变更。通过使用迁移，您可以将数据库结构的更改跟踪为一系列的迁移脚本，从而简化了数据库结构的管理和维护。

以下是Yii框架中数据库迁移脚本管理的一些关键概念和步骤：

1. 安装Yii

首先，确保您已经安装了Yii框架。如果还没有安装，可以通过Composer进行安装：

composer global require "fxp/composer-asset-plugin:^1.2.0"
composer create-project --prefer-dist yiisoft/yii2-app-basic basic

2. 配置数据库

在config/db.php文件中配置您的数据库连接信息。例如：

return [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=your_database',
    'username' => 'your_username',
    'password' => 'your_password',
    'charset' => 'utf8',
];

3. 创建迁移类

使用Yii的迁移命令行工具创建一个新的迁移类。例如，创建一个名为CreateUsersTable的迁移类：

php yii migrate/create CreateUsersTable

这将在migrations目录下生成一个新的迁移文件，例如m190101_000000_create_users_table.php。

4. 编写迁移脚本

打开生成的迁移文件，编写迁移脚本。例如：

<?php

use yii\db\Migration;

class m190101_000000_create_users_table extends Migration
{
    public function up()
    {
        $this->createTable('users', [
            'id' => $this->primaryKey(),
            'username' => $this->string()->notNull(),
            'email' => $this->string()->notNull()->unique(),
            'password_hash' => $this->string()->notNull(),
            'created_at' => $this->integer()->notNull(),
            'updated_at' => $this->integer()->notNull(),
        ]);
    }

    public function down()
    {
        $this->dropTable('users');
    }
}

5. 运行迁移

使用Yii的迁移命令行工具运行迁移脚本。例如：

php yii migrate

这将应用迁移脚本到数据库中，创建users表。

6. 管理迁移历史

Yii提供了一个迁移历史工具，可以查看和管理已应用的迁移。例如，查看已应用的迁移：

php yii migrate/history

回滚上一次的迁移：

php yii migrate/rollback --step=1

7. 创建自定义迁移命令

如果您需要创建自定义的迁移命令，可以在console/controllers目录下创建一个新的控制器，例如MigrateController.php：

<?php

namespace console\controllers;

use yii\console\Controller;
use yii\db\Migration;

class MigrateController extends Controller
{
    public function actionCreate($name)
    {
        $this->createMigration($name);
    }

    protected function createMigration($name)
    {
        $class = "app\\migrations\\$name";
        if (!class_exists($class)) {
            $this->stdout("Creating migration class: $class\n");
            $this->createFile($class, $this->generateMigrationClass($name));
        } else {
            $this->stdout("Migration class already exists: $class\n");
        }
    }

    protected function generateMigrationClass($name)
    {
        $table = str_replace(['Create', 'Table'], '', $name);
        return "public function up()
{
    \$this->createTable('$table', [
        // migration fields here
    ]);
}

public function down()
{
    \$this->dropTable('$table');
}
";
    }

    protected function createFile($className, $content)
    {
        $file = Yii::getAlias('@app/migrations') . "/$className.php";
        if (!file_exists(dirname($file))) {
            mkdir(dirname($file), 0755, true);
        }
        file_put_contents($file, $content);
        $this->stdout("File created: $file\n");
    }
}

然后，您可以使用以下命令创建自定义迁移：

php yii migrate/create CreateCustomTable

通过这些步骤，您可以在Yii框架中有效地管理数据库迁移脚本。