Laravel 数据库迁移概述
在 laravel 应用开发中，数据库迁移（migrations）提供了一种版本控制数据库架构的方法。通过迁移，团队可以轻松地修改和共享应用的数据库架构，而无需手动执行 sql 命令。每次数据库结构发生变化（例如添加新表、新列或修改现有列）时，都会创建一个新的迁移文件来描述这些更改。
当需要向现有数据库添加新表，同时又不希望影响或丢失已存储数据时，理解 php artisan migrate 命令的正确用法以及 Schema 门面提供的不同操作至关重要。
安全添加新表与修改表结构
Laravel 的迁移系统旨在支持数据库的增量更新。这意味着当您创建新的迁移文件并运行 php artisan migrate 命令时，系统只会执行那些尚未运行过的迁移。对于添加新表或修改现有表结构，以下 Schema 门面提供的方法是数据安全的：
1. 创建新表 (Schema::create())
当您需要添加一个全新的表时，应使用 Schema::create() 方法。这个操作只会创建指定的表，而不会对数据库中已有的任何其他表或其数据造成影响。
示例代码： 首先，创建一个新的迁移文件：
php artisan make:migration create_new_products_table --create=products
然后，在生成的迁移文件的 up() 方法中定义新表的结构：
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::create('products', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->text('description')->nullable();
$table->decimal('price', 8, 2);
$table->timestamps();
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::dropIfExists('products');
}
};2. 修改现有表 (Schema::table())
如果您需要向现有表添加新列、修改列类型或添加索引等，应使用 Schema::table() 方法。此操作专门用于修改表结构，同样不会导致现有数据的丢失。
示例代码： 创建一个修改表的迁移文件：
php artisan make:migration add_category_to_products_table --table=products
在生成的迁移文件的 up() 方法中添加新列：
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
return new class extends Migration
{
/**
* Run the migrations.
*/
public function up(): void
{
Schema::table('products', function (Blueprint $table) {
$table->foreignId('category_id')->nullable()->after('name')->constrained();
});
}
/**
* Reverse the migrations.
*/
public function down(): void
{
Schema::table('products', function (Blueprint $table) {
$table->dropForeign(['category_id']);
$table->dropColumn('category_id');
});
}
};3. 重命名表 (Schema::rename())
如果您需要重命名一个表，可以使用 Schema::rename() 方法。此操作仅更改表的名称，表中的所有数据将保持不变。
示例代码：
Schema::rename('old_table_name', 'new_table_name');4. 删除表 (Schema::drop() / Schema::dropIfExists())
需要特别注意的是，Schema::drop() 或 Schema::dropIfExists() 方法用于删除整个表。执行这些操作将导致该表中的所有数据永久丢失。因此，在生产环境中应谨慎使用，并确保已进行数据备份。
示例代码：
Schema::drop('users'); // 删除 users 表及其所有数据
Schema::dropIfExists('old_table'); // 如果 old_table 存在则删除执行迁移命令
在创建了新的迁移文件（无论是创建新表还是修改现有表）之后，只需运行以下命令即可将其应用到数据库：
php artisan migrate
这个命令会检查 migrations 表中记录的已执行迁移，并只运行那些尚未执行的迁移文件。这是在不影响现有数据的情况下更新数据库架构的标准且安全的方法。
了解迁移状态
您可以使用以下命令查看所有迁移文件的执行状态：
php artisan migrate:status
该命令会显示每个迁移文件是否已运行 (Ran? 列)，以及它们属于哪个批次 (Batch 列)。
示例输出：
+------+-------------------------------------------------------+-------+ | Ran? | Migration | Batch | +------+-------------------------------------------------------+-------+ | Yes | 2014_10_12_000000_create_users_table | 1 | | Yes | 2014_10_12_100000_create_password_resets_table | 1 | | Yes | 2015_10_12_100000_create_vendors_table | 1 | | Yes | 2015_10_12_100001_create_channels_table | 1 | | No | 2023_01_01_100000_create_products_table | | | No | 2023_01_02_100000_add_category_to_products_table | | +------+-------------------------------------------------------+-------+
通过此输出，您可以清晰地看到哪些迁移已成功应用，哪些尚未执行。
警惕可能导致数据丢失的命令
在进行数据库操作时，务必区分 php artisan migrate 与其他可能导致数据丢失的命令：
- php artisan migrate: 运行所有未执行的迁移。通常不会丢失数据（除非迁移文件中明确包含了 Schema::drop() 等删除操作）。
- php artisan migrate:fresh: 删除所有表，然后重新运行所有迁移。此命令将导致所有数据永久丢失。
- php artisan migrate:refresh: 回滚所有迁移，然后重新运行所有迁移。此命令也将导致所有数据永久丢失。
- php artisan migrate:reset: 回滚所有迁移。此命令将导致所有数据永久丢失。
- php artisan migrate:rollback: 回滚最近一次批次的迁移。如果回滚的迁移中包含 Schema::create()，则会删除相应的表；如果包含 Schema::table()，则会撤销其修改。这可能导致部分数据丢失或结构回退。
最佳实践与注意事项
- 始终使用迁移文件： 避免手动修改数据库结构，确保所有更改都通过迁移文件进行版本控制。
- 测试环境先行： 在将迁移应用到生产环境之前，务必在开发和测试环境中充分测试，验证其行为是否符合预期。
- 数据备份： 在对生产数据库执行任何重要的迁移操作之前，务必进行完整的数据库备份。
- 理解 up() 和 down() 方法： up() 方法定义了数据库结构要进行的更改，而 down() 方法则定义了如何撤销这些更改。确保 down() 方法能够安全地回滚 up() 方法所做的操作。
- 避免在 up() 方法中执行数据操作： 迁移文件主要用于修改数据库结构。如果需要插入、更新或删除数据，应考虑使用 Seeder 文件或单独的脚本。
总结
在 Laravel 中，通过 php artisan migrate 命令配合 Schema::create() 和 Schema::table() 方法，您可以安全地向数据库添加新表或修改现有表结构，而无需担心丢失原有数据。关键在于理解不同 Schema 操作的语义及其对数据的影响，并严格避免在生产环境中使用 migrate:fresh 或 migrate:refresh 等会清空数据库的命令，除非您明确需要重置整个数据库。遵循这些指导原则，将确保您的数据库架构演进过程既高效又安全。
