Initial Commit

Author: ahmard

.gitignore

@@ -0,0 +1,3 @@
+/.idea/
+/vendor/
+/composer.lock

README.md

@@ -0,0 +1,36 @@
+# PHP Server
+
+## Installation
+```
+composer require ahmard/php-server
+```
+
+## Usage
+### PHP Built-In Server
+
+- With document root
+```php
+use PHPServer\BuiltIn\Server;
+
+Server::create('127.0.0.1', '9900')
+    ->setDocumentRoot(__DIR__)
+    ->start();
+```
+
+- Route request to single entry file
+```php
+use PHPServer\BuiltIn\Server;
+
+Server::create('127.0.0.1', '9900')
+    ->setRouterScript(__DIR__ . 'public/index.php')
+    ->start();
+```
+
+- Provide callable to be invoked when request is received
+```php
+use PHPServer\BuiltIn\Server;
+
+Server::create('127.0.0.1', '9900')
+    ->onRequest(fn() => var_dump('Request Received'))
+    ->start();
+```

composer.json

@@ -0,0 +1,25 @@
+{
+    "name": "ahmard/php-server",
+    "description": "PHP local server helper",
+    "type": "library",
+    "license": "MIT",
+    "require": {
+        "php": "^8.0",
+        "react/child-process": "^0.6.3"
+    },
+    "require-dev": {
+        "phpstan/phpstan": "^0.12.98",
+        "symfony/var-dumper": "^5.3"
+    },
+    "autoload": {
+        "psr-4": {
+            "PHPServer\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "ahmard",
+            "email": "ahmard06@gmail.com"
+        }
+    ]
+}

src/BuiltIn/Factory.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace PHPServer\BuiltIn;
+
+use InvalidArgumentException;
+
+class Factory
+{
+    public static function create(Server ...$servers): Factory
+    {
+        return new Factory($servers);
+    }
+
+    /**
+     * @param Server[] $servers
+     */
+    public function __construct(protected array $servers)
+    {
+        foreach ($this->servers as $server) {
+            if (!$server instanceof Server) {
+                $serverClass = $server::class;
+                throw new InvalidArgumentException("$serverClass must be an instance of " . Server::class);
+            }
+        }
+    }
+
+    public function serve(): void
+    {
+        foreach ($this->servers as $server){
+            ServerProcess::create($server);
+        }
+    }
+}

src/BuiltIn/Server.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace PHPServer\BuiltIn;
+
+use Closure;
+use JetBrains\PhpStorm\ArrayShape;
+use JetBrains\PhpStorm\Pure;
+
+class Server
+{
+    protected string|null $documentRoot = null;
+    protected string|null $routerScript = null;
+    protected Closure|null $requestCallback = null;
+
+
+    #[Pure] public static function create(float|string $host, int $port): Server
+    {
+        return new Server($host, $port);
+    }
+
+    public function __construct(
+        protected float|string $host,
+        protected int $port
+    )
+    {
+    }
+
+    public function setDocumentRoot(string $path): Server
+    {
+        $this->documentRoot = $path;
+        return $this;
+    }
+
+    public function setRouterScript(string $filePath): Server
+    {
+        $this->routerScript = $filePath;
+        return $this;
+    }
+
+    public function onRequest(callable $callback): Server
+    {
+        $this->requestCallback = $callback;
+        return $this;
+    }
+
+    public function start(): StartedServer
+    {
+        return new StartedServer($this, ServerProcess::create($this));
+    }
+
+    #[ArrayShape(['host' => "int|string", 'port' => "int", 'document_root' => "null|string", 'router_script' => "null|string", 'request_callback' => "\Closure|null"])]
+    public function getInfo(): array
+    {
+        return [
+            'host' => $this->host,
+            'port' => $this->port,
+            'document_root' => $this->documentRoot,
+            'router_script' => $this->routerScript,
+            'request_callback' => $this->requestCallback,
+        ];
+    }
+}

src/BuiltIn/ServerProcess.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace PHPServer\BuiltIn;
+
+use JetBrains\PhpStorm\Pure;
+use React\ChildProcess\Process;
+
+class ServerProcess
+{
+    public static function create(Server $server)
+    {
+        dump(self::getConsoleCommand($server));
+        $process = new Process('echo foo');
+        $process->start();
+
+        $process->stdout->on('data', function ($chunk) {
+            // echo $chunk;
+        });
+
+        $process->on('exit', function ($exitCode, $termSignal) {
+            //echo 'Process exited with code ' . $exitCode . PHP_EOL;
+        });
+
+        return $process;
+    }
+
+    #[Pure] protected static function getConsoleCommand(Server $server): string
+    {
+        $config = $server->getInfo();
+        $command = "php -S {$config['host']}:{$config['port']}";
+
+        if (isset($config['document_root'])) {
+            $command .= " -t {$config['document_root']}";
+        } else {
+            if (isset($config['router_script'])) {
+                $command .= " {$config['router_script']}";
+            }
+        }
+
+        return $command;
+    }
+}

src/BuiltIn/StartedServer.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace PHPServer\BuiltIn;
+
+use React\ChildProcess\Process;
+
+class StartedServer
+{
+    public function __construct(
+        protected Server $server,
+        protected Process $process
+    )
+    {
+    }
+
+    /**
+     * @return Process
+     */
+    public function getProcess(): Process
+    {
+        return $this->process;
+    }
+
+    /**
+     * @return Server
+     */
+    public function getServer(): Server
+    {
+        return $this->server;
+    }
+}

test.php

@@ -0,0 +1,17 @@
+<?php
+
+use PHPServer\BuiltIn\Server;
+
+require 'vendor/autoload.php';
+
+Server::create('127.0.0.1', '9900')
+    ->setDocumentRoot(__DIR__)
+    ->start();
+
+Server::create('127.0.0.1', '9901')
+    ->setRouterScript('index.php')
+    ->start();
+
+Server::create('127.0.0.1', '9902')
+    ->setDocumentRoot(__DIR__)
+    ->start();