Laravel如何创建和运行数据库迁移?(Migration详解)

2次阅读

laravel数据库迁移是管理结构变更的核心机制,通过Artisan命令创建带时间戳的迁移文件,用up()和down()方法实现可逆操作,仅处理结构变更,运行用migrate命令,回滚用migrate:rollback。

Laravel如何创建和运行数据库迁移?(Migration详解)

在 Laravel 中,数据库迁移(Migration)是管理数据库结构变更的核心机制,它让团队协作和环境部署更安全、可追溯。创建和运行迁移其实不复杂,但关键在于理解它的设计逻辑和常见用法。

如何创建一个迁移文件

Laravel 提供 Artisan 命令快速生成迁移文件,文件会自动存放在 database/migrations/ 目录下,并带时间戳前缀,确保执行顺序。

  • 创建一张新表:运行 php artisan make:migration create_users_table,Laravel 会生成类似 2024_05_10_123456_create_users_table.php 的文件
  • 为已有表添加字段:用 php artisan make:migration add_email_to_users_table,文件名体现意图,便于后续识别
  • 如果想指定表名或字段,可以加 –create=posts–table=users 参数,命令会自动填充基础结构

迁移文件里写什么

每个迁移类包含两个核心方法:up() 定义“升级”操作(如建表、加字段),down() 定义“回滚”操作(如删表、删字段),必须一一对应,保证可逆性。

  • up() 中使用 Schema 构建器定义结构,比如 Schema::create('posts', function (Blueprint $table) { $table->id(); $table->String('title'); $table->timestamps(); });
  • down() 一般直接删表:Schema::dropIfExists('posts');;如果是修改字段,需用 dropColumn()renameColumn() 等明确操作
  • 不要在迁移中写业务逻辑或大量数据操作,迁移只管结构。数据填充用 Seeder,不是 Migration

如何运行和回滚迁移

迁移文件写好后,用 Artisan 命令触发实际的数据库变更:

Laravel如何创建和运行数据库迁移?(Migration详解)

NameGPT

免费的名称生成器,ai驱动在线生成企业名称及Logo

Laravel如何创建和运行数据库迁移?(Migration详解) 104

查看详情 Laravel如何创建和运行数据库迁移?(Migration详解)

  • 执行所有未运行的迁移:php artisan migrate,Laravel 自动按时间戳顺序执行,并记录到 migrations 表中
  • 只运行某一个迁移(调试用):php artisan migrate –path=database/migrations/2024_05_10_123456_create_posts_table.php
  • 回滚上一次迁移:php artisan migrate:rollback;回滚最近 3 次:php artisan migrate:rollback –step=3
  • 重置全部迁移再重跑(慎用,仅开发环境):php artisan migrate:resetphp artisan migrate

实用小贴士

迁移不是一劳永逸,日常开发中有些细节容易忽略但影响很大:

  • 每次修改迁移文件后,别直接改已提交的迁移——应新建迁移来修正,否则团队其他成员执行会出错
  • 运行 php artisan migrate:status 可查看哪些迁移已执行、哪些待执行,状态一目了然
  • 线上环境运行迁移前,务必先备份数据库;避免在生产环境用 migrate:refreshreset
  • 如果迁移失败,检查数据库用户权限、字段长度限制(如 mysql 默认 varchar(255) 加索引需指定长度)、引擎类型(InnoDB 支持外键)等底层约束

基本上就这些。迁移本质是“版本控制 + SQL 脚本化”,写清楚意图、保持可逆、小步提交,就能稳住数据库演进节奏。

以上就是Laravel如何创建和运行数据库迁移?(Migration详解)的详细内容,更多请关注php中文网其它相关文章!

text=ZqhQzanResources