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框架中有效地管理數據庫遷移腳本。