0

0

Laravel迁移干嘛用?迁移文件如何创建执行?

月夜之吻

月夜之吻

发布时间:2025-09-05 08:32:02

|

623人浏览过

|

来源于php中文网

原创

Laravel迁移通过PHP代码实现数据库版本控制,解决团队协作、环境一致性及回滚难题。开发者使用Artisan命令创建迁移文件,定义up()和down()方法管理数据库变更,执行migrate命令同步结构,支持rollback、refresh等操作确保可追溯与安全回滚,避免直接修改数据库导致的失控风险。

laravel迁移干嘛用?迁移文件如何创建执行?

Laravel迁移,简单来说,就是用代码管理数据库结构变化的工具。它把原本需要你手动编写SQL语句来创建、修改或删除数据库表、字段的繁琐过程,转化成了更优雅、可版本控制的PHP代码。这对于团队协作和环境部署来说,简直是救星。

解决方案

Laravel迁移的核心作用是实现数据库的版本控制。它允许你通过PHP代码来定义和修改数据库结构,而不是直接去操作SQL文件或数据库管理工具。这样做的好处是多方面的,也是我个人在实际项目中深有体会的地方。

首先,它解决了团队协作中的大痛点。想象一下,一个项目有多个开发者,每个人都在修改数据库结构,比如有人加了新表,有人给旧表加了字段。如果没有迁移,你们需要不断地同步SQL文件,或者口头告知,这中间极易出错,而且合并冲突简直是噩梦。但有了迁移,这些变更都以代码的形式存在,可以和业务代码一起提交到版本控制系统(比如Git),大家拉取最新代码后,运行一个命令就能同步数据库结构,冲突解决也变得清晰可控。

其次,它保证了不同环境之间(开发、测试、生产)数据库结构的一致性。我遇到过不少情况,开发环境的数据库结构是A版本,测试环境是B版本,生产环境又是C版本,导致各种莫名其妙的bug。迁移强制了这种一致性,每次部署都确保数据库结构是预期的最新版本。

最后,它提供了可追溯性和回滚能力。每次数据库结构的变化都被记录在一个独立的迁移文件中,你可以清楚地看到历史上的每一次变更。如果某个变更导致了问题,你也可以轻松地回滚到之前的稳定状态,这在紧急情况下尤其重要。我记得有一次,上线后发现某个新字段的类型定义错了,导致数据写入失败,幸好有迁移,快速回滚然后修复再部署,避免了长时间的服务中断。

如何创建和编写一个Laravel迁移文件?

创建Laravel迁移文件,最常用的方式就是通过Artisan命令行工具。这就像是Laravel给你提供了一个魔法棒,轻轻一点,文件就为你准备好了。

如果你想创建一个全新的表,比如

users
表,你可以运行:
php artisan make:migration create_users_table --create=users
这里的
create_users_table
是迁移文件的命名,Laravel会根据这个名字生成一个带时间戳的文件名。
--create=users
参数则告诉Artisan,这个迁移是用来创建
users
表的,它会自动在生成的迁移文件中为你添加一些基础的表结构代码。

如果你只是想给已有的表添加或修改字段,比如给

users
表添加一个
email
字段,你可以这样:
php artisan make:migration add_email_to_users_table --table=users
--table=users
参数会生成一个空的
up()
down()
方法,你需要手动在里面编写修改表结构的代码。

迁移文件生成后,你会发现它位于

database/migrations
目录下。每个迁移文件都包含两个核心方法:
up()
down()

Baklib
Baklib

在线创建产品手册、知识库、帮助文档

下载
  • up()
    方法:当执行迁移时,这个方法会被调用。你在这里定义数据库结构的变化,比如创建表、添加字段、修改字段类型等。
  • down()
    方法:当回滚迁移时,这个方法会被调用。它应该包含
    up()
    方法操作的逆向逻辑,比如删除表、删除字段等,确保回滚操作能恢复到之前的状态。

举个简单的例子,一个创建

products
表的迁移文件可能看起来像这样:

id(); // 自增主键
            $table->string('name')->unique(); // 产品名称,唯一
            $table->text('description')->nullable(); // 产品描述,可为空
            $table->decimal('price', 8, 2); // 价格,总共8位,小数点后2位
            $table->timestamps(); // created_at 和 updated_at 字段
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('products'); // 如果表存在,则删除
    }
};

这里的

Schema::create
Schema::dropIfExists
是Laravel提供的Schema Builder的一部分,它允许你用更具表现力的PHP代码来定义数据库结构,而不用直接写SQL。

Laravel迁移文件创建后该如何执行?以及如何回滚?

创建好迁移文件只是第一步,要让这些数据库结构的变化真正生效,你还需要执行它们。Artisan工具再次派上用场。

执行迁移: 最基本的执行命令是:

php artisan migrate
当你运行这个命令时,Laravel会检查
database/migrations
目录下所有尚未执行的迁移文件,并按照时间戳的顺序依次运行它们的
up()
方法。Laravel会在你的数据库中维护一个
migrations
表,用来记录哪些迁移已经运行过,所以它不会重复执行。

回滚迁移: 有时候,你可能需要撤销最近的数据库结构变更,这时候就需要回滚操作。

  • 回滚最近一批迁移:

    php artisan migrate:rollback
    这个命令会回滚最近一次执行的(一批)迁移。也就是说,如果你一次性执行了5个新的迁移,这个命令会把这5个都回滚掉,调用它们的
    down()
    方法。

  • 回滚所有迁移:

    php artisan migrate:reset
    这个命令会回滚所有已经运行过的迁移,相当于把数据库结构恢复到初始状态(即所有迁移都未执行前的状态)。

  • 刷新数据库(回滚并重新执行所有迁移):

    php artisan migrate:refresh
    这个命令实际上是
    migrate:reset
    migrate
    的组合。它会先回滚所有迁移,然后重新运行所有迁移。这在开发过程中非常有用,当你频繁修改数据库结构并希望快速重置数据库到最新状态时,它能帮你省不少事。不过,请务必注意
    migrate:refresh
    会丢失所有数据,所以千万不要在生产环境轻易使用!

  • 彻底刷新数据库(删除所有表并重新执行所有迁移):

    php artisan migrate:fresh
    这是更彻底的重置。它会删除数据库中所有的表,然后重新运行所有迁移。这个命令比
    migrate:refresh
    更“暴力”,因为它不依赖于
    down()
    方法来回滚,而是直接清空数据库。在开发初期,当你数据库结构变动非常频繁,或者想确保数据库完全干净时,这个命令很好用。但同样,它会丢失所有数据,生产环境严禁使用。

我个人在开发阶段,

php artisan migrate:refresh --seed
(结合填充器)几乎是我的日常操作。每次数据库结构有变动,或者想测试某个功能,一键重置数据库并填充测试数据,效率直接拉满。但上线前,我都会再三确认,生怕手滑在生产环境敲错命令。

为什么不直接在数据库里修改,非要用迁移?

这其实是一个非常经典的问题,尤其是对于刚接触Laravel或者习惯了直接操作数据库的开发者来说。说实话,刚开始接触Laravel迁移的时候,我也曾不以为然,觉得直接写SQL不是更快吗?或者直接在Navicat、DataGrip里点点鼠标不香吗?但很快我就被打脸了,尤其是在团队协作和项目迭代中,迁移的价值简直是无可替代的。

版本控制的缺失: 直接在数据库里修改,最大的问题就是缺乏版本控制。你的数据库结构就像一个黑箱,你修改了什么,什么时候修改的,为什么修改的,都很难追溯。这就像你在Git项目里不提交就改代码,然后期望别人知道你改了什么。一旦出了问题,想要回溯到某个版本,几乎是不可能完成的任务。迁移则把数据库结构变更纳入了代码版本控制,每一次变更都清晰可见。

环境差异的噩梦: 我经历过最痛苦的场景之一就是开发、测试、生产环境数据库结构不一致。开发人员可能在本地加了个字段,但忘记告诉测试人员,导致测试环境的某个功能报错。或者生产环境的数据库结构因为某些原因被手动修改了,和代码库里的预期不符,导致上线后出现各种奇葩bug。迁移强制了这种一致性。只要大家运行相同的迁移,所有环境的数据库结构就应该是一致的。

团队协作的障碍: 在一个团队中,如果大家都是直接修改数据库,那么同步数据库结构会成为一个巨大的负担。新加入的成员需要一份最新的SQL文件来初始化数据库,而每次有人修改了结构,都需要通知所有人更新。这不仅效率低下,而且极易出错。迁移则简化了这个流程,新成员只需要拉取代码,运行

php artisan migrate
,数据库结构就自动同步了。

可回滚性与错误恢复: 直接修改数据库,一旦改错了,想要恢复往往很麻烦,可能需要手动执行逆向SQL,甚至从备份中恢复。而迁移的

down()
方法天生就是为回滚而设计的。如果某个变更导致了问题,一个
php artisan migrate:rollback
就能让你快速回到之前的稳定状态,大大降低了风险。

抽象与可读性: 虽然SQL本身是数据库操作的语言,但通过Laravel的Schema Builder,我们用更具表现力的PHP代码来定义数据库结构。这不仅提高了可读性,也让数据库结构变更与业务逻辑代码更加紧密地结合在一起,更符合面向对象的开发理念。

当然,对于个人小项目,或者一些快速原型开发,直接操作数据库可能确实更快。但一旦项目规模扩大,或者有团队协作,迁移所带来的规范性、可维护性和稳定性,绝对是值得前期投入的。它前期可能增加了那么一点点“仪式感”,但长期来看,省下来的时间和规避的风险是巨大的。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2899

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1734

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1567

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

1120

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1546

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1277

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1669

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1310

2023.11.13

拼多多赚钱的5种方法 拼多多赚钱的5种方法
拼多多赚钱的5种方法 拼多多赚钱的5种方法

在拼多多上赚钱主要可以通过无货源模式一件代发、精细化运营特色店铺、参与官方高流量活动、利用拼团机制社交裂变,以及成为多多进宝推广员这5种方法实现。核心策略在于通过低成本、高效率的供应链管理与营销,利用平台社交电商红利实现盈利。

31

2026.01.26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号