Laravel迁移文件怎么创建和回滚

来源:AI智能体作者:USDT程序员头衔:程序员
导读:本期聚焦于小伙伴创作的《Laravel迁移文件怎么创建和回滚》,敬请观看详情,探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《Laravel迁移文件怎么创建和回滚》有用,将其分享出去将是对创作者最好的鼓励。

Laravel的迁移文件是管理数据库表结构变更的核心工具,通过它可以快速创建、修改、删除数据表,同时支持版本回溯,避免直接操作数据库带来的风险。迁移文件默认存放在database/migrations目录下,每个文件都对应一次数据库结构变更操作。

Laravel迁移文件怎么创建和回滚

一、创建Laravel迁移文件

创建迁移文件主要通过Laravel自带的Artisan命令行工具完成,根据需求不同,创建方式分为以下几种:

1. 创建基础迁移文件

如果需要创建一个空的迁移文件,用于自定义表结构变更逻辑,可以执行以下命令:

php artisan make:migration create_test_table

执行后会生成类似2024_05_20_123456_create_test_table.php的文件,文件名前缀是创建时间,保证执行顺序正确。

2. 创建带表名和操作的迁移文件

如果需要直接指定要创建的数据表名称,或者要修改已有表结构,可以带上--create--table参数:

  • --create=表名:表示本次迁移用于创建指定数据表
  • --table=表名:表示本次迁移用于修改指定已存在的数据表

例如要创建一个名为users的用户表迁移文件,执行命令:

php artisan make:migration create_users_table --create=users

生成的迁移文件已经预设了updown方法的基础结构,up方法定义执行迁移时的操作,down方法定义回滚时的操作。

3. 迁移文件内容编写示例

以创建users表为例,迁移文件的up方法内容如下:

<?php

use IlluminateDatabaseMigrationsMigration;
use IlluminateDatabaseSchemaBlueprint;
use IlluminateSupportFacadesSchema;

class CreateUsersTable extends Migration
{
    /**
     * 执行迁移
     *
     * @return void
     */
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamp('email_verified_at')->nullable();
            $table->string('password');
            $table->rememberToken();
            $table->timestamps();
        });
    }

    /**
     * 回滚迁移
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('users');
    }
}

二、执行迁移文件

编写好迁移文件后,需要执行迁移命令将变更同步到数据库:

php artisan migrate

执行后Laravel会读取所有未执行过的迁移文件,按照文件名的时间顺序依次执行up方法,同时会在数据库的migrations表中记录已执行的迁移文件名,避免重复执行。

如果执行迁移时出现字段重复、表已存在等错误,可以先回滚再重新执行,或者修改迁移文件后重置迁移。

三、回滚Laravel迁移文件

回滚操作可以撤销已经执行的迁移变更,根据需求不同,回滚方式分为以下几种:

1. 回滚最近一次迁移

如果需要撤销最近一次执行的迁移操作,执行以下命令:

php artisan migrate:rollback

该命令会执行最近一次迁移批次中所有文件的down方法,比如一次执行了3个迁移文件,回滚时会同时撤销这3个文件的变更。

2. 回滚指定步数的迁移

如果需要回滚最近多次的迁移操作,可以带上--step参数指定回滚的批次数量:

# 回滚最近3次迁移批次
php artisan migrate:rollback --step=3

3. 回滚所有迁移

如果需要撤销所有已经执行的迁移变更,执行以下命令:

php artisan migrate:reset

该命令会按照迁移执行的逆序,依次执行所有已执行迁移文件的down方法,最终清空所有迁移创建的表结构。

4. 重置并重新执行所有迁移

如果需要先回滚所有迁移,再重新执行所有迁移,可以使用以下命令:

php artisan migrate:refresh

该命令相当于先执行migrate:reset,再执行migrate,常用于开发阶段调整表结构后重新初始化数据库。

如果需要重新执行迁移时带上种子数据填充,可以加上--seed参数:

php artisan migrate:refresh --seed

四、迁移相关注意事项

  • 迁移文件一旦提交到版本库,尽量不要修改已经执行过的迁移文件内容,避免团队协作时出现数据库结构不一致的问题,新增变更建议创建新的迁移文件
  • 生产环境执行迁移前,建议先在测试环境验证迁移文件的正确性,避免误操作导致数据丢失
  • 如果需要修改已执行迁移的表结构,不要直接修改原迁移文件,而是创建新的修改表迁移文件,使用Schema::table方法添加、修改、删除字段

修改表结构的迁移文件示例,给users表添加age字段:

<?php

use IlluminateDatabaseMigrationsMigration;
use IlluminateDatabaseSchemaBlueprint;
use IlluminateSupportFacadesSchema;

class AddAgeToUsersTable extends Migration
{
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->integer('age')->nullable()->after('name');
        });
    }

    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('age');
        });
    }
}

Laravelmigration数据库迁移artisan命令修改时间:2026-06-26 07:54:30

免责声明:​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们处理。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。