Lar*el如何创建和运行数据库迁移？（Migration详解）

新闻中心 NEWS CENTER

2025-12-12

浏览次数：次

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

laravel如何创建和运行数据库迁移？（migration详解）

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

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

创建一张新表：运行 php artisan make:migration create_users_table，Lar*el 会生成类似 2025_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 命令触发实际的数据库变更：

Procys

AI驱动的发票数据处理

102 查看详情 Procys

执行所有未运行的迁移：php artisan migrate，Lar*el 自动按时间戳顺序执行，并记录到 migrations 表中
只运行某一个迁移（调试用）：php artisan migrate --path=database/migrations/2025_05_10_123456_create_posts_table.php
回滚上一次迁移：php artisan migrate:rollback；回滚最近 3 次：php artisan migrate:rollback --step=3
重置全部迁移再重跑（慎用，仅开发环境）：php artisan migrate:reset → php artisan migrate

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

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