add php convenience method

Author: gwleuverink

src/ChildProcess.php

@@ -59,14 +59,9 @@ public function start(
         bool $persistent = false
     ): static {
 
-        if (is_string($cmd)) {
-            // When a string is passed, explode it on the space
-            $cmd = array_values(array_filter(explode(' ', $cmd)));
-        }
-
         $process = $this->client->post('child-process/start', [
             'alias' => $alias,
-            'cmd' => $cmd,
+            'cmd' => $this->explodeCommand($cmd),
             'cwd' => $cwd ?? base_path(),
             'env' => $env,
             'persistent' => $persistent,
@@ -75,9 +70,16 @@ public function start(
         return $this->fromRuntimeProcess($process);
     }
 
+    public function php(string|array $cmd, string $alias, ?array $env = null, ?bool $persistent = false): self
+    {
+        $cmd = [PHP_BINARY, ...$this->explodeCommand($cmd)];
+
+        return $this->start($cmd, $alias, env: $env, persistent: $persistent);
+    }
+
     public function artisan(string|array $cmd, string $alias, ?array $env = null, ?bool $persistent = false): self
     {
-        $cmd = [PHP_BINARY, 'artisan', ...(array) $cmd];
+        $cmd = [PHP_BINARY, 'artisan', ...$this->explodeCommand($cmd)];
 
         return $this->start($cmd, $alias, env: $env, persistent: $persistent);
     }
@@ -124,4 +126,13 @@ protected function fromRuntimeProcess($process): static
 
         return $this;
     }
+
+    private function explodeCommand(string|array $cmd): array
+    {
+        if (is_iterable($cmd)) {
+            return $cmd;
+        }
+
+        return array_values(array_filter(explode(' ', $cmd)));
+    }
 }

tests/ChildProcess/ChildProcessTest.php

@@ -32,7 +32,7 @@
 });
 
 it('can start a php command', function () {
-    ChildProcess::artisan("-r 'sleep(5);'", 'some-alias', ['baz' => 'zah']);
+    ChildProcess::php("-r 'sleep(5);'", 'some-alias', ['baz' => 'zah']);
 
     Http::assertSent(function (Request $request) {
         return $request->url() === 'http://localhost:4000/api/child-process/start' &&
@@ -41,15 +41,15 @@
                $request['cwd'] === base_path() &&
                $request['env'] === ['baz' => 'zah'];
     });
-})->todo();
+});
 
 it('can start a artisan command', function () {
-    ChildProcess::artisan('foo:bar', 'some-alias', ['baz' => 'zah']);
+    ChildProcess::artisan('foo:bar --verbose', 'some-alias', ['baz' => 'zah']);
 
     Http::assertSent(function (Request $request) {
         return $request->url() === 'http://localhost:4000/api/child-process/start' &&
                $request['alias'] === 'some-alias' &&
-               $request['cmd'] === [PHP_BINARY, 'artisan', 'foo:bar'] &&
+               $request['cmd'] === [PHP_BINARY, 'artisan', 'foo:bar', '--verbose'] &&
                $request['cwd'] === base_path() &&
                $request['env'] === ['baz' => 'zah'];
     });
@@ -64,12 +64,12 @@
 });
 
 it('accepts either a string or a array as php command argument', function () {
-    ChildProcess::artisan(" 'sleep(5);'", 'some-alias');
+    ChildProcess::php("-r 'sleep(5);'", 'some-alias');
     Http::assertSent(fn (Request $request) => $request['cmd'] === [PHP_BINARY, '-r', "'sleep(5);'"]);
 
     ChildProcess::artisan(['-r', "'sleep(5);'"], 'some-alias');
     Http::assertSent(fn (Request $request) => $request['cmd'] === [PHP_BINARY, '-r', "'sleep(5);'"]);
-})->todo();
+});
 
 it('accepts either a string or a array as artisan command argument', function () {
     ChildProcess::artisan('foo:bar', 'some-alias');
@@ -119,7 +119,7 @@
 it('can mark a php command as persistent', function () {
     ChildProcess::php("-r 'sleep(5);'", 'some-alias', persistent: true);
     Http::assertSent(fn (Request $request) => $request['persistent'] === true);
-})->todo();
+});
 
 it('can mark a artisan command as persistent', function () {
     ChildProcess::artisan('foo:bar', 'some-alias', persistent: true);