如何在Laravel迁移中为所有已存在的数据表添加新列

实现步骤 #

• 第一步：生成迁移文件
  执行Artisan命令创建新的迁移文件：
  php artisan make:migration add_custom_column_to_all_tables
  生成的文件会保存在项目database/migrations/目录下。

• 第二步：编写迁移逻辑
  打开生成的迁移文件，分别编写up（执行迁移）和down（回滚迁移）方法，示例代码如下：

  <?php
  
  use Illuminate\Database\Migrations\Migration;
  use Illuminate\Database\Schema\Blueprint;
  use Illuminate\Support\Facades\Schema;
  use Illuminate\Support\Facades\DB;
  
  return new class extends Migration
  {
      public function up()
      {
          // 配置要排除的表，例如迁移记录表本身不需要加字段
          $excludeTables = ['migrations'];
          // 获取当前数据库连接下的所有表名
          $allTables = DB::connection()->getDoctrineSchemaManager()->listTableNames();
  
          foreach ($allTables as $tableName) {
              if (in_array($tableName, $excludeTables)) {
                  continue;
              }
              Schema::table($tableName, function (Blueprint $table) {
                  // 此处替换为你实际需要新增的列类型、列名和属性
                  // 示例为新增可空的租户ID字段，放在id字段之后
                  $table->string('tenant_id')->nullable()->after('id');
              });
          }
      }
  
      public function down()
      {
          $excludeTables = ['migrations'];
          $allTables = DB::connection()->getDoctrineSchemaManager()->listTableNames();
  
          foreach ($allTables as $tableName) {
              if (in_array($tableName, $excludeTables)) {
                  continue;
              }
              Schema::table($tableName, function (Blueprint $table) {
                  // 回滚时删除对应字段，替换为你的实际列名
                  $table->dropColumn('tenant_id');
              });
          }
      }
  };
  

• 第三步：执行前置依赖检查
  Laravel修改表结构需要依赖doctrine/dbal库，执行以下命令安装：
  composer require doctrine/dbal

• 第四步：执行迁移
  确认数据库备份完成后，执行迁移命令生效：
  php artisan migrate

注意事项 #

• 执行迁移前必须先备份全量数据库，避免操作失误导致数据丢失
• 如果新增的列设置了非空约束，需要先为现有数据表填充默认值，否则迁移会执行失败
• 多数据库连接的项目需要手动指定对应的连接名，例如DB::connection('mysql_slave')->getDoctrineSchemaManager()->listTableNames()，同时Schema操作也要指定连接Schema::connection('mysql_slave')->table(...)
• 单库表数量超过100的场景建议分批次执行，避免单次请求超时导致迁移执行不完整

内容的提问来源于stack exchange，提问作者swatantra