ThinkPHP6.0 数据迁移工具 migration 入门使用教程

最新推荐文章于 2026-04-27 10:00:29 发布

原创

最新推荐文章于 2026-04-27 10:00:29 发布 · 5.5k 阅读

标签

#php #ThinkPHP6.0 #数据迁移工具 #migrate

本文介绍了如何在ThinkPHP6.0框架下利用Composer安装数据库迁移工具，通过创建和执行迁移文件来管理数据库结构。创建迁移文件涉及change方法，用于定义表结构和操作，如添加字段和索引。执行迁移通过`migrate:run`命令实现，回滚则使用`migrate:rollback`，支持按版本或日期回滚。

开始前需要做好的准备工作：

搭建好 PHP 开发环境（推荐 phpstudy，PHP>=7.2.5，MySql5.7.x）。

安装好 ThinkPHP6.0，并做配置可正常连接到 MySql 数据库。

安装好 Composer。

安装数据库迁移工具

使用 Composer 安装数据库迁移工具：

composer require topthink/think-migration

安装成功后，通过php think list查看相关指令：
Alt text
上面截图中红色框线区域为数据库迁移相关指令。我们常用的其中的三个：

migrate:create 创建一个迁移
migrate:rollback 回滚
migrate:run 执行迁移

下文我以用户表为例进行介绍。

创建迁移文件

首先通过migrate:create指令生成一个迁移脚本（含基础代码结构的文件）
```
php think migrate:create User
```
执行成功的结果如下：

我们可以看到，执行结果是在项目根目录多一个database/migrations目录，来存放迁移脚本文件，文件名格式YYYYMMDDHHMMSS_my_new_migration.php，前 14 个字符就是当前时间戳（精确到秒），后面就是自定义的迁移名称。

修改迁移脚本内容
上文自动创建的迁移脚本文件只是一个框架文件，并没有具体实现。我们可以在这个文件中编码来创建新表、插入数据、增加索引和修改字段等。其中有一个空方法change，我们就在这个方法内进行迁移。

修改前的迁移脚本文件内容：

<?php

use think\migration\Migrator;
use think\migration\db\Column;

class User extends Migrator
{
     
     
    /**
    * Change Method.
    *
    * Write your reversible migrations using this method.
    *
    * More information on writing migrations is available here:
    * http://docs.phinx.org/en/latest/migrations.html#the-abstractmigration-class
    *
    * The following commands can be used in this method and Phinx will
    * automatically reverse them when rolling back:
    *
    *    createTable
    *    renameTable
    *    addColumn
    *    renameColumn
    *    addIndex
    *    addForeignKey
    *
    * Remember to call "create()" or "update()" and NOT "save()" when working
    * with the Table class.
    */
    public function change()
    {
     
     

    }
}