Laravel数据库迁移是什么_Laravel数据库迁移入门【基础】

文章小白一枚，正在不断学习积累知识，现将学习到的知识记录一下，也是将我的所得分享给大家！而今天这篇文章《Laravel数据库迁移是什么_Laravel数据库迁移入门【基础】》带大家来了解一下##content_title##，希望对大家的知识积累有所帮助，从而弥补自己的不足，助力实战开发！

数据库迁移是用PHP代码描述表结构变更，通过up()和down()方法实现可重复、可回退、跨环境执行；必须新建迁移处理变更，禁止修改已执行文件；migrate按时间戳顺序执行并记录批次，rollback按批回退，fresh会清空重跑但生产禁用。

数据库迁移不是“把数据搬走”，而是用 PHP 代码描述表结构变更，并让这些变更可重复、可回退、可跨环境执行。

迁移文件本质是带 up() 和 down() 的 PHP 类

每个 database/migrations/xxx_create_users_table.php 文件就是一个迁移类，必须实现两个方法：

• up()：定义“这次要怎么改结构”——建表、加字段、设索引、加外键
• down()：定义“万一出错怎么撤回”——删表、删字段、删索引（建议统一用 Schema::dropIfExists() 而非 Schema::drop()，避免表不存在时报错）

别手动改已执行过的迁移文件。哪怕只改了一个字段注释，也应新建迁移来修正，否则在其他环境执行时会因 checksum 或时间戳不一致失败。

php artisan migrate 不等于“运行所有 PHP 文件”

它实际做三件事：检查 migrations 表里哪些记录缺失 → 按文件名前缀（时间戳）排序 → 逐个执行 up() 并往 migrations 表插入记录。所以：

• 如果中途报错（比如字段长度超限），migrations 表可能只写入了部分记录，下次再跑 migrate 会跳过已记的，但卡住的那条不会自动重试
• MySQL 5.7.7 以下或 MariaDB 10.2.2 以下默认不支持 utf8mb4 索引全长度，得在 AppServiceProvider::boot() 里加 Schema::defaultStringLength(191)
• 执行前确保 .env 中 DB_CONNECTION、DB_DATABASE 等配置正确，且数据库已存在（Laravel 不自动创建库）

增删字段必须走新迁移，不能直接改旧文件

比如要给 users 表加 phone 字段，正确做法是：

• 运行 php artisan make:migration add_phone_to_users_table --table=users
• 在新文件的 up() 里写 $table->string('phone')->nullable();
• 在 down() 里写 $table->dropColumn('phone');
• 再跑 php artisan migrate

常见错误是编辑已执行的迁移文件，在 up() 里追加字段——这会导致其他机器首次迁移时字段重复添加，或回滚时 down() 逻辑不匹配原始结构。

rollback 不是“撤销上一条 SQL”，而是按批回退

php artisan migrate:rollback 默认回退**最后一批**（batch）迁移，一批可能含多个文件（比如你一次跑了 3 个新迁移，它们共享同一个 batch ID）。所以：

• 想只退一个文件？用 --step=1，但前提是那个文件是该 batch 唯一成员
• 想彻底清空重来？php artisan migrate:fresh 会先删所有表（不含 migrations 表），再重跑全部迁移——注意：它不保留任何数据
• 生产环境禁用 :fresh 和 :reset，它们会无条件删除表

真正难处理的永远不是“怎么加字段”，而是“字段加完后，已有数据如何适配默认值或非空约束”——这部分没法靠迁移自动完成，得配合 DB::statement() 或单独写填充器。

今天关于《Laravel数据库迁移是什么_Laravel数据库迁移入门【基础】》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！