use FrankenPHP's built-in file watcher

Author: kohenkatz

src/Commands/Concerns/InstallsFrankenPhpDependencies.php

@@ -22,7 +22,7 @@ trait InstallsFrankenPhpDependencies
      *
      * @var string
      */
-    protected $requiredFrankenPhpVersion = '1.1.0';
+    protected $requiredFrankenPhpVersion = '1.3.0';
 
     /**
      * Ensure the FrankenPHP's Caddyfile and worker script are installed.

src/Commands/StartFrankenPhpCommand.php

@@ -103,7 +103,9 @@ public function handle(ServerProcessInspector $inspector, ServerStateFile $serve
             'CADDY_SERVER_LOGGER' => 'json',
             'CADDY_SERVER_SERVER_NAME' => $serverName,
             'CADDY_SERVER_WORKER_COUNT' => $this->workerCount() ?: '',
+            'CADDY_SERVER_WORKER_DIRECTIVE' => $this->workerCount() ? "num {$this->workerCount()}" : '',
             'CADDY_SERVER_EXTRA_DIRECTIVES' => $this->buildMercureConfig(),
+            'CADDY_SERVER_WATCH_DIRECTIVES' => $this->buildWatchConfig(),
         ]));
 
         $server = $process->start();
@@ -189,6 +191,25 @@ protected function buildMercureConfig()
         return "$config\n\t\t}";
     }
 
+    /**
+     * Generate the file watcher configuration snippet to include in the Caddyfile.
+     *
+     * @return string
+     */
+    protected function buildWatchConfig()
+    {
+        if (! $this->option('watch')) {
+            return '';
+        }
+
+        // If paths are not specified, fall back to FrankenPHP's default watcher pattern
+        if (empty($paths = config('octane.watch'))) {
+            return "\t\twatch";
+        }
+
+        return collect($paths)->map(fn ($path) => "\t\twatch ".base_path($path))->join("\n");
+    }
+
     /**
      * Get the maximum number of seconds that workers should be allowed to execute a single request.
      *
@@ -348,4 +369,19 @@ protected function stopServer()
             '--server' => 'frankenphp',
         ]);
     }
+
+    /**
+     * Always return a no-op object, because FrankenPHP has native
+     * watcher support, so there is no need for an external watcher.
+     */
+    protected function startServerWatcher()
+    {
+        return new class
+        {
+            public function __call($method, $parameters)
+            {
+                return null;
+            }
+        };
+    }
 }

src/Commands/stubs/Caddyfile

@@ -4,7 +4,11 @@
 	admin {$CADDY_SERVER_ADMIN_HOST}:{$CADDY_SERVER_ADMIN_PORT}
 
 	frankenphp {
-		worker "{$APP_PUBLIC_PATH}/frankenphp-worker.php" {$CADDY_SERVER_WORKER_COUNT}
+		worker {
+			file "{$APP_PUBLIC_PATH}/frankenphp-worker.php"
+			{$CADDY_SERVER_WORKER_DIRECTIVE}
+			{$CADDY_SERVER_WATCH_DIRECTIVES}
+		}
 	}
 }