编辑“︁PHP数据库迁移”︁（章节）

= PHP数据库迁移 =

== 介绍 ==
'''数据库迁移'''（Database Migration）是指在软件开发过程中，对数据库结构进行版本控制的系统性方法。在PHP开发中，它允许开发者以可重复、可追溯的方式修改数据库架构（如创建表、添加字段或修改索引），通常与应用程序代码变更同步进行。

数据库迁移的核心价值包括：
* '''版本控制'''：像管理代码一样管理数据库结构变更
* '''团队协作'''：确保所有开发者的数据库环境一致
* '''回滚能力'''：可撤销错误的数据库修改
* '''环境一致性'''：使开发、测试和生产环境的数据库保持同步

== 基本原理 ==

=== 迁移文件结构 ===
典型的迁移文件包含两个核心方法：
<syntaxhighlight lang="php">
class CreateUsersTable {
    public function up() {
        // 执行迁移的操作
    }

    public function down() {
        // 回滚迁移的操作
    }
}
</syntaxhighlight>

=== 工作流程 ===
<mermaid>
graph TD
    A[创建迁移文件] --> B[编写up/down方法]
    B --> C[执行迁移]
    C --> D{需要回滚?}
    D -->|是| E[执行down方法]
    D -->|否| F[继续新迁移]
</mermaid>

== 实现方式 ==

=== 使用原生SQL ===
最基础的实现方式：
<syntaxhighlight lang="php">
// 迁移示例
$db->query("CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
)");

// 回滚示例
$db->query("DROP TABLE users");
</syntaxhighlight>

=== 使用迁移工具 ===
主流PHP框架都提供迁移工具：

==== Laravel迁移示例 ====
<syntaxhighlight lang="php">
// 创建表迁移
Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->timestamps();
});

// 修改表迁移
Schema::table('users', function (Blueprint $table) {
    $table->string('email')->unique()->after('name');
});
</syntaxhighlight>

==== Symfony迁移示例 ====
<syntaxhighlight lang="php">
// 通过Doctrine Migrations
$this->addSql('CREATE TABLE user (id INT AUTO_INCREMENT NOT NULL, username VARCHAR(255) NOT NULL, PRIMARY KEY(id))');
</syntaxhighlight>

== 实际案例 ==

=== 场景：电商平台用户系统升级 ===
'''需求'''：在现有users表中添加手机号验证字段并建立索引

1. 创建迁移文件：
<syntaxhighlight lang="bash">
php artisan make:migration add_phone_verification_to_users_table
</syntaxhighlight>

2. 编写迁移：
<syntaxhighlight lang="php">
public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->string('phone')->nullable()->after('email');
        $table->timestamp('phone_verified_at')->nullable();
        $table->index(['phone']); // 添加索引
    });
}

public function down()
{
    Schema::table('users', function (Blueprint $table) {
        $table->dropColumn(['phone', 'phone_verified_at']);
        $table->dropIndex(['phone']); // 移除索引
    });
}
</syntaxhighlight>

3. 执行迁移：
<syntaxhighlight lang="bash">
php artisan migrate
</syntaxhighlight>

== 高级主题 ==

=== 数据迁移 ===
当需要同时修改数据结构'''和'''转移现有数据时：
<syntaxhighlight lang="php">
public function up()
{
    // 1. 创建新表
    Schema::create('new_posts', function (Blueprint $table) {
        // ... 新结构
    });
    
    // 2. 转移数据
    $posts = DB::table('old_posts')->get();
    foreach ($posts as $post) {
        DB::table('new_posts')->insert([
            // 数据转换逻辑
        ]);
    }
    
    // 3. 删除旧表
    Schema::drop('old_posts');
}
</syntaxhighlight>

=== 测试迁移 ===
重要迁移应该包含测试：
<syntaxhighlight lang="php">
public function test_phone_verification_migration()
{
    // 执行迁移
    $this->artisan('migrate');
    
    // 验证结构变更
    $this->assertTrue(Schema::hasColumn('users', 'phone'));
    $this->assertTrue(Schema::hasColumn('users', 'phone_verified_at'));
    
    // 回滚测试
    $this->artisan('migrate:rollback');
    $this->assertFalse(Schema::hasColumn('users', 'phone'));
}
</syntaxhighlight>

== 最佳实践 ==

* '''小步迁移'''：每个迁移文件只做一件事
* '''描述性命名'''：如 `2023_01_01_000000_create_users_table.php`
* '''环境隔离'''：开发环境和生产环境使用相同迁移流程
* '''备份优先'''：执行生产环境迁移前先备份数据
* '''版本控制'''：将迁移文件与代码一起纳入版本管理

== 数学表示 ==
迁移操作可以形式化表示为：
<math>
M = (S, D, \delta)
</math>
其中：
* <math>S</math> 是当前数据库状态
* <math>D</math> 是目标数据库状态
* <math>\delta</math> 是从<math>S</math>到<math>D</math>的状态转换函数

== 常见问题 ==

'''Q：迁移失败怎么办？'''
A：检查错误信息，修复问题后可使用：
<syntaxhighlight lang="bash">
php artisan migrate:fresh  # 完全重置数据库
</syntaxhighlight>

'''Q：如何在不同环境同步迁移状态？'''
A：使用迁移状态表记录已执行的迁移，通常框架会自动维护此表。

== 总结 ==
PHP数据库迁移是现代Web开发中维护数据库结构的重要实践。通过系统化的迁移管理，团队可以高效协作，减少环境差异导致的问题，并确保数据库变更的可追溯性。从简单的表结构变更到复杂的数据迁移，合理的迁移策略能显著提升项目的可维护性。

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP数据库操作]]