feat(custom-executable): ability to specify preferred PHP executable file

Author: Ahmard

README.md

@@ -5,7 +5,7 @@ A small library to help run PHP servers easily and quickly.
 ## Installation
 
 ```
-composer require ahmard/php-server
+composer require ahmard/php-server --dev
 ```
 
 ## Usage
@@ -55,3 +55,17 @@ Server::create('127.0.0.1', '9900')
     ->onRequest(fn() => var_dump('Request Received'))
     ->start();
 ```
+
+- Use preferred php version/executable
+
+```php
+use PHPServer\BuiltIn\Server;
+
+Server::create('127.0.0.1', '9900')
+    ->setWorkers(2)
+    ->setPHPExecutable('/usr/bin/php8.0')
+    ->onRequest(fn() => var_dump('Request Received'))
+    ->start();
+```
+
+Enjoy 😎

src/BuiltIn/Server.php

@@ -12,14 +12,15 @@ class Server extends AbstractServer
 {
     protected string|null $documentRoot = null;
     protected string|null $routerScript = null;
+    protected string $PHPExecutable = 'php';
     protected Closure|null $requestCallback = null;
     protected int|null $workers = null;
 
 
     public function getCommand(): ServerCommand
     {
         $config = $this->getInfo();
-        $command = "php -S {$config->getHost()}:{$config->getPort()}";
+        $command = "$this->PHPExecutable -S {$config->getHost()}:{$config->getPort()}";
 
         if (null != $this->workers) {
             $command = "PHP_CLI_SERVER_WORKERS=$this->workers $command";
@@ -68,4 +69,16 @@ public function setWorkers(int $num): static
         $this->workers = $num;
         return $this;
     }
+
+    /**
+     * Use custom/preferred php version/executable
+     *
+     * @param string $path
+     * @return $this
+     */
+    public function setPHPExecutable(string $path): static
+    {
+        $this->PHPExecutable = $path;
+        return $this;
+    }
 }

test-builtin.php

@@ -7,5 +7,6 @@
 Server::create('0.0.0.0', 9904)
     ->onRequest(fn() => var_dump('Request Received'))
     ->setWorkers(3)
+    ->setPHPExecutable('/usr/bin/php8.0')
     ->start()
     ->logOutputToConsole();