本文档将指导你如何在Laravel生产环境中，向已存在的 participants 表格安全地添加外键 campaign_id，以建立与 campaign 表格的多对一关系。重点解决在不丢失现有数据的前提下，如何避免 NOT NULL 约束引发的迁移错误，并提供了一种通过现有数据关系填充新列的有效方法。通过本文，开发者可以学习如何在生产环境中优雅地处理数据库结构变更。
在生产环境中添加外键列
在开发过程中，我们有时会遇到需要在生产环境中修改数据库结构的情况。直接运行 php artisan migrate:fresh 会导致数据丢失，因此我们需要一种更安全的方法。本例中，我们需要向已存在的 participants 表格添加 campaign_id 外键列，该列与 campaign 表格存在多对一关系。
迁移文件
首先，创建一个新的迁移文件，例如 add_campaign_id_to_participants：
php artisan make:migration add_campaign_id_to_participants
然后，打开新创建的迁移文件，并修改 up() 方法：
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
use App\Models\Participant;
class AddCampaignIdToParticipants extends Migration
{
/**
* Run the migrations.
*
* @return void
*/
public function up()
{
Schema::table('participants', function (Blueprint $table) {
$table->unsignedBigInteger('campaign_id')->default(0);
});
$participants = Participant::all();
foreach($participants as $participant)
{
$participant->campaign_id = $participant->visitor->campaign_id;
$participant->save();
}
}
/**
* Reverse the migrations.
*
* @return void
*/
public function down()
{
Schema::table('participants', function (Blueprint $table) {
$table->dropColumn('campaign_id');
});
}
}代码解释：
- Schema::table('participants', function (Blueprint $table) { ... });: 这部分代码定义了对 participants 表格的修改。
- $table->unsignedBigInteger('campaign_id')->default(0);: 这行代码添加了 campaign_id 列，类型为无符号大整数，并设置默认值为 0。设置默认值是解决 NOT NULL 约束的关键。
- $participants = Participant::all();: 获取所有 Participant 模型的实例。
- foreach($participants as $participant) { ... }: 循环遍历每个 Participant 实例。
- $participant->campaign_id = $participant->visitor->campaign_id;: 根据 participant 与 visitor 和 campaign 的关系，从 visitor 表格的 campaign_id 字段获取对应的值，并赋值给 participant 的 campaign_id 字段。
- $participant->save();: 保存 participant 模型的修改。
注意事项
- 数据关系： 上述代码依赖于 participants 表格与 visitors 表格和 campaign 表格之间的关系。你需要确保这些关系在你的模型中已经正确定义。
- 默认值： 设置 campaign_id 的默认值为 0 是为了避免 NOT NULL 约束导致的错误。在填充数据之后，你可以根据实际情况修改默认值或添加约束。
- 性能： 如果 participants 表格的数据量非常大，循环遍历所有记录并更新可能会影响性能。可以考虑使用分批处理或使用原生SQL语句进行更新。
- 回滚： down() 方法中，我们删除了 campaign_id 列，以便在需要时回滚迁移。
运行迁移
最后，运行迁移：
php artisan migrate
总结
通过以上步骤，我们可以在Laravel生产环境中安全地向现有表格添加外键列，并避免数据丢失。关键在于设置合理的默认值，并利用现有的数据关系填充新列。同时，需要注意性能问题，并确保数据关系的正确性。这种方法也适用于其他类似的数据库结构变更场景。
