Laravel迁移通过PHP代码管理数据库结构变更,使用Artisan命令创建、修改和回滚数据表,确保团队协作与部署一致性。

在 Laravel 中,数据库迁移(Migrations)是一种管理数据库结构变更的便捷方式。它允许你用 PHP 代码定义表的创建、修改和删除,从而实现数据库版本控制,便于团队协作和部署。
1. 创建迁移文件
使用 Artisan 命令行工具可以快速生成迁移文件:
创建新数据表:
php artisan make:migration create_users_table --create=users
修改已有数据表(如添加字段):
php artisan make:migration add_email_to_users_table --table=users
执行后,Laravel 会在 database/migrations 目录下生成一个带时间戳的 PHP 文件,例如:2025_04_05_000000_create_users_table.php。
2. 编写迁移逻辑
打开生成的迁移文件,主要编辑 up() 和 down() 方法:
up() 方法 定义要执行的数据库变更(如创建表或添加字段):
public function up()
{
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();
});
}
down() 方法 定义回滚操作(撤销变更):
public function down()
{
Schema::dropIfExists('users');
}
如果是修改表结构,比如添加字段:
public function up()
{
Schema::table('users', function (Blueprint $table) {
$table->string('phone')->nullable();
});
}
public function down()
{
Schema::table('users', function (Blueprint $table) {
$table->dropColumn('phone');
});
}
3. 运行迁移
编写完成后,使用以下命令执行迁移:
运行所有未执行的迁移:
php artisan migrate
执行后,Laravel 会按文件名顺序运行尚未执行的迁移,并自动在数据库中创建 migrations 表来记录已运行的迁移。
回滚上一次迁移(rollback):
php artisan migrate:rollback
回滚所有迁移:
php artisan migrate:reset
刷新数据库(先回滚再重新运行所有迁移):
php artisan migrate:refresh
开发时常用此命令重置数据库结构。
带种子数据刷新:
php artisan migrate:refresh --seed
适用于清空并重新填充测试数据。
4. 注意事项
- 确保 .env 文件中的数据库配置正确(DB_CONNECTION、DB_DATABASE 等)。
- 迁移文件命名需遵循格式:YYYY_MM_DD_HHMMSS_action_table_name.php,Laravel 依赖时间戳排序。
- 生产环境慎用
migrate:rollback或refresh,建议结合数据备份。 - 可使用
php artisan migrate --force在生产环境跳过确认提示。










