[11.x] Added an event that reports files being deleted when calling t…

…he `schema:dump --prune` command (#53870)

* Added an event that reports files being deleted when calling the `schema:dump --prune` command

* Rename event classes to better reflect functionality and update usage accordingly

* formatting

---------

Co-authored-by: Taylor Otwell <[email protected]>

src/Illuminate/Database/Console/DumpCommand.php

@@ -6,6 +6,7 @@
 use Illuminate\Contracts\Events\Dispatcher;
 use Illuminate\Database\Connection;
 use Illuminate\Database\ConnectionResolverInterface;
+use Illuminate\Database\Events\MigrationsPruned;
 use Illuminate\Database\Events\SchemaDumped;
 use Illuminate\Filesystem\Filesystem;
 use Illuminate\Support\Facades\Config;
@@ -52,10 +53,12 @@ public function handle(ConnectionResolverInterface $connections, Dispatcher $dis
 
         if ($this->option('prune')) {
             (new Filesystem)->deleteDirectory(
-                database_path('migrations'), $preserve = false
+                $path = database_path('migrations'), $preserve = false
             );
 
             $info .= ' and pruned';
+
+            $dispatcher->dispatch(new MigrationsPruned($connection, $path));
         }
 
         $this->components->info($info.' successfully.');

src/Illuminate/Database/Events/MigrationsPruned.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Illuminate\Database\Events;
+
+use Illuminate\Database\Connection;
+
+class MigrationsPruned
+{
+    /**
+     * The database connection instance.
+     *
+     * @var \Illuminate\Database\Connection
+     */
+    public $connection;
+
+    /**
+     * The database connection name.
+     *
+     * @var string|null
+     */
+    public $connectionName;
+
+    /**
+     * The path to the directory where migrations were pruned.
+     *
+     * @var string
+     */
+    public $path;
+
+    /**
+     * Create a new event instance.
+     *
+     * @param  \Illuminate\Database\Connection  $connection
+     * @param  string  $path
+     * @return void
+     */
+    public function __construct(Connection $connection, string $path)
+    {
+        $this->connection = $connection;
+        $this->connectionName = $connection->getName();
+        $this->path = $path;
+    }
+}