feat(migrations): shouldRun method on migration classes.

src/Illuminate/Database/Migrations/Migration.php

@@ -27,4 +27,14 @@ public function getConnection()
     {
         return $this->connection;
     }
+
+    /**
+     * Should this migration run or not.
+     *
+     * @return bool
+     */
+    public function shouldRun(): bool
+    {
+        return true;
+    }
 }

src/Illuminate/Database/Migrations/Migrator.php

@@ -140,6 +140,18 @@ public function run($paths = [], array $options = [])
         return $migrations;
     }
 
+     /**
+     * Determine if the migration should be ran.
+     *
+     * @param  string  $file
+     * @return bool
+     */
+    public function shouldMigrationBeRan($file)
+    {
+        $instance = $this->resolvePath($file);
+        return $instance instanceof Migration ? $instance->shouldRun() : false;
+    }
+
     /**
      * Get the migration files that have not yet run.
      *
@@ -155,6 +167,7 @@ protected function pendingMigrations($files, $ran)
             ->reject(fn ($file) => in_array($migrationName = $this->getMigrationName($file), $ran) ||
                 in_array($migrationName, $migrationsToSkip)
             )
+            ->filter(fn ($file) => $this->shouldMigrationBeRan($file))
             ->values()
             ->all();
     }

tests/Database/DatabaseMigrationMigrateCommandTest.php

@@ -33,6 +33,7 @@ public function testBasicMigrationsCallMigratorWithProperArguments()
             return $callback();
         });
         $migrator->shouldReceive('setOutput')->once()->andReturn($migrator);
+        $migrator->shouldReceive('shouldMigrationBeRan')->andReturn(true);
         $migrator->shouldReceive('run')->once()->with([__DIR__.DIRECTORY_SEPARATOR.'migrations'], ['pretend' => false, 'step' => false]);
         $migrator->shouldReceive('getNotes')->andReturn([]);
         $migrator->shouldReceive('repositoryExists')->once()->andReturn(true);

tests/Database/migrations/should_run/2016_01_01_200000_create_flights_table.php

@@ -0,0 +1,37 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateFlightsTable extends Migration
+{
+
+    public function shouldRun(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('flights', function (Blueprint $table) {
+            $table->increments('id');
+            $table->string('name');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('flights');
+    }
+}