feature: Allow registering a post-installation hook

Author: elnurvl

src/Sail.php

@@ -8,6 +8,7 @@
 /**
  * @method static self setBaseTemplate(string $stub)
  * @method static self addService(string $service, ?string $stubPath = null, ?bool $persistent = null, ?bool $default = null, ?bool $dependency = null, ?Closure $configuringEnv = null, ?Closure $afterInstall = null)
+ * @method static self registerInstallHook(Closure $closure)
  * @method static self registerPublishHook(Closure $closure)
  * @method static string getBaseTemplate()
  * @method static array availableServices(bool $default = false)

src/Services.php

@@ -59,6 +59,13 @@ class Services
      */
     protected string $composeStub = __DIR__ . '/../stubs/docker-compose.stub';
 
+    /**
+     * Hooks to be run after all services are configured
+     *
+     * @var Closure[]
+     */
+    protected array $afterInstall = [];
+
     /**
      * Hooks to be run during the publish command
      *
@@ -237,6 +244,19 @@ public function addService(string   $service,
         return $this;
     }
 
+    /**
+     * Add a hook to the pipeline executed during the installation command.
+     *
+     * @param Closure $closure
+     * @return $this
+     */
+    public function registerInstallHook(Closure $closure): self
+    {
+        $this->afterInstall[] = $closure;
+
+        return $this;
+    }
+
     /**
      * Add a hook to the pipeline executed during the publish command.
      *
@@ -328,7 +348,7 @@ public function replaceEnvVariables(string $environment, array $services): strin
     }
 
     /**
-     * Execute hooks for the requested services.
+     * Execute hooks set for the installation command.
      *
      * @param Command $command
      * @param array $services
@@ -342,6 +362,9 @@ public function runInstallHooks(Command $command, array $services, string $appSe
                 $this->services[$service]['after_install']($command, $services, $appService);
             }
         }
+        foreach ($this->afterInstall as $hook) {
+            $hook($command, $services, $appService);
+        }
     }
 
     /**