数据迁移 Migration

轻量级数据库迁移与数据填充模块。

目录结构

database/
├── migrations/    # 迁移文件
└── seeders/       # 数据填充文件

命令

php lee migrate:run              # 执行所有未执行的迁移
php lee migrate:rollback         # 回滚全部迁移
php lee migrate:rollback --steps=1   # 回滚最近 1 步
php lee seed:run                 # 执行所有 Seeder

编写迁移

文件名格式：YYYYMMDDHHMMSS_描述.php，类名为描述的驼峰形式。

// database/migrations/20240101000000_create_users_table.php
<?php

use Lychee\migration\Migration;

class CreateUsersTable extends Migration
{
    public function up(): void
    {
        $this->table('users')
            ->addColumn('name', 'string', ['length' => 100])
            ->addColumn('email', 'string', ['length' => 255])
            ->addTimestamps()
            ->addSoftDelete()
            ->create();
    }

    public function down(): void
    {
        $this->table('users')->drop();
    }
}

表构建器常用方法

$table = $this->table('table_name');

// 字段
$table->addColumn('name', 'varchar', ['length' => 100]);
$table->addColumn('age', 'integer', ['unsigned' => true]);
$table->addColumn('price', 'decimal', ['precision' => 10, 'scale' => 2]);
$table->addColumn('status', 'boolean');
$table->addColumn('content', 'text');
$table->addColumn('data', 'json');

// 便捷方法
$table->addTimestamps();        // create_time, update_time
$table->addSoftDelete();        // delete_time

// 索引
$table->addIndex(['email'], ['type' => 'UNIQUE']);

// 操作
$table->create();               // 建表
$table->drop();                 // 删表
$table->update();               // 应用改表变更
$table->removeColumn('field');
$table->changeColumn('field', 'varchar', ['length' => 200]);

数据填充

// database/seeders/UserSeeder.php
<?php

use Lychee\migration\Seeder;

class UserSeeder extends Seeder
{
    public function run(): void
    {
        $this->insert('users', [
            'name'  => 'admin',
            'email' => 'admin@example.com',
        ]);

        $this->insertBatch('users', [
            ['name' => 'a', 'email' => 'a@b.com'],
            ['name' => 'b', 'email' => 'b@c.com'],
        ]);
    }
}

数据库连接

优先使用 config/database.php 配置的数据库；不可用时兜底到 SQLite（runtime/migration.sqlite）。