fix: child process cmd: option except iterable array (#429)

* fix: child process cmd: option except iterable array

TypeError: settings.cmd is not iterable at startPhpProcess

* fix: throw an exception if $cmd is not an indexed array

* fix: array_values but with a hint for static analyzer

Author: SRWieZ

src/ChildProcess.php

@@ -52,17 +52,22 @@ public function all(): array
         return $hydrated;
     }
 
+    /**
+     * @param  string|string[]  $cmd
+     * @return $this
+     */
     public function start(
         string|array $cmd,
         string $alias,
         ?string $cwd = null,
         ?array $env = null,
         bool $persistent = false
     ): static {
+        $cmd = is_array($cmd) ? array_values($cmd) : [$cmd];
 
         $process = $this->client->post('child-process/start', [
             'alias' => $alias,
-            'cmd' => (array) $cmd,
+            'cmd' => $cmd,
             'cwd' => $cwd ?? base_path(),
             'env' => $env,
             'persistent' => $persistent,
@@ -71,11 +76,17 @@ public function start(
         return $this->fromRuntimeProcess($process);
     }
 
+    /**
+     * @param  string|string[]  $cmd
+     * @return $this
+     */
     public function php(string|array $cmd, string $alias, ?array $env = null, ?bool $persistent = false): self
     {
+        $cmd = is_array($cmd) ? array_values($cmd) : [$cmd];
+
         $process = $this->client->post('child-process/start-php', [
             'alias' => $alias,
-            'cmd' => (array) $cmd,
+            'cmd' => $cmd,
             'cwd' => $cwd ?? base_path(),
             'env' => $env,
             'persistent' => $persistent,
@@ -84,9 +95,15 @@ public function php(string|array $cmd, string $alias, ?array $env = null, ?bool
         return $this->fromRuntimeProcess($process);
     }
 
+    /**
+     * @param  string|string[]  $cmd
+     * @return $this
+     */
     public function artisan(string|array $cmd, string $alias, ?array $env = null, ?bool $persistent = false): self
     {
-        $cmd = ['artisan', ...(array) $cmd];
+        $cmd = is_array($cmd) ? array_values($cmd) : [$cmd];
+
+        $cmd = ['artisan', ...$cmd];
 
         return $this->php($cmd, $alias, env: $env, persistent: $persistent);
     }