Laravel通过Migration实现数据库版本控制,使用Artisan命令如make:migration创建迁移文件,在up()中定义表结构、字段类型与索引,down()用于回滚;通过migrate执行迁移,支持fresh、refresh、rollback等操作管理变更,结合Schema构建器可安全修改表结构,提升团队协作效率。

Laravel 的数据库迁移(Migration)功能让你能够以代码的形式管理数据库结构,实现团队协作中的数据库版本控制。通过 Artisan 命令行工具,你可以轻松创建、修改和回滚数据表。以下是 Laravel 数据库迁移的常用写法与命令汇总,帮助你高效管理项目数据库。
创建迁移文件
使用 Artisan 命令生成新的迁移文件:
- php artisan make:migration create_users_table —— 创建一个基础迁移文件
- php artisan make:migration add_email_to_users_table --table=users —— 修改已有表时使用,会自动填充表名
- php artisan make:migration create_posts_table --create=posts —— 创建用于新建 posts 表的迁移
执行后会在 database/migrations 目录下生成带时间戳的 PHP 文件,包含 up() 和 down() 方法。
在迁移中定义字段和索引
在迁移文件的 up() 方法中使用 Schema 构建器来定义表结构:
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(); // 创建 created_at 和 updated_at
});
常见字段类型:
- $table->id():自增 ID
- $table->string('name', 100):指定长度的字符串
- $table->text('content'):长文本
- $table->integer('votes'):整数
- $table->boolean('active'):布尔值
- $table->dateTime('created_at'):日期时间
- $table->foreignId('user_id'):外键字段,常用于关联
添加索引:
- $table->unique('email'):唯一索引
- $table->index('name'):普通索引
- $table->primary('id'):主键
添加外键约束:
$table->foreignId('user_id')->constrained()->onDelete('cascade');
运行与回滚迁移
将迁移文件同步到数据库:
- php artisan migrate —— 执行所有未运行的迁移
- php artisan migrate:fresh —— 删除所有表并重新运行迁移(慎用,清空数据)
- php artisan migrate:refresh —— 回滚所有迁移再重新执行
- php artisan migrate:reset —— 回滚所有迁移
- php artisan migrate:rollback —— 回滚最近一次迁移(step=1)
- php artisan migrate:rollback --step=3 —— 回滚最近三次迁移
生成迁移来修改现有表
若需为已存在的表添加字段或修改结构,先创建迁移:
php artisan make:migration add_avatar_to_users_table --table=users然后在 up() 中使用 table() 方法:
Schema::table('users', function (Blueprint $table) {
$table->string('avatar')->nullable();
});
记得在 down() 中移除该字段以支持回滚:
$table->dropColumn('avatar');
其他实用命令
- php artisan migrate:status —— 查看所有迁移的执行状态
- php artisan make:migration create_posts_table --create=posts --path=/database/migrations/blog —— 指定迁移存储路径
- php artisan migrate --database=testing —— 指定数据库连接
- php artisan migrate --pretend —— 模拟执行,输出 SQL 而不真正执行
基本上就这些。掌握这些命令和写法,你就能高效地用 Laravel 管理数据库结构变更,避免手动操作出错,提升开发效率。










