Adding pure Laminas PSR runtime (#23)

* Adding pure Laminas PSR runtime

* normalize

* CS fix

Author: Nyholm

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [nyholm]

.gitignore

@@ -0,0 +1,2 @@
+/vendor/
+composer.lock

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Tobias Nyholm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,62 @@
+# PSR-7 and PSR-15 Runtime
+
+A runtime with `laminas/diactoros` and `laminas/laminas-httphandlerrunner`.
+
+## Installation
+
+```
+composer require runtime/psr-laminas
+```
+
+## Usage
+
+This runtime is discovered automatically. You can force your application to use
+this runtime by defining the environment variable `APP_RUNTIME`.
+
+```
+APP_RUNTIME=Runtime\PsrLaminas\Runtime
+```
+
+### PSR-7
+
+```php
+// public/index.php
+
+use Psr\Http\Server\RequestHandlerInterface;
+
+require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+return function (ServerRequestInterface $request) {
+    $response = new \Laminas\Diactoros\Response();
+    $response->getBody()->write('PSR-7');
+
+    return $response;
+};
+```
+
+### PSR-15
+
+```php
+// public/index.php
+
+use Psr\Http\Server\RequestHandlerInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Message\ResponseInterface;
+
+require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+class Application implements RequestHandlerInterface {
+    // ...
+    public function handle(ServerRequestInterface $request): ResponseInterface
+    {
+        $response = new \Laminas\Diactoros\Response();
+        $response->getBody()->write('PSR-15');
+
+        return $response;
+    }
+}
+
+return function (array $context) {
+    return new Application($context['APP_ENV'] ?? 'dev');
+};
+```

composer.json

@@ -0,0 +1,33 @@
+{
+    "name": "runtime/psr-laminas",
+    "type": "library",
+    "description": "PSR runtime with laminas/diactoros and laminas/laminas-httphandlerrunner",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Tobias Nyholm",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "laminas/laminas-diactoros": "^2.5",
+        "laminas/laminas-httphandlerrunner": "^1.2",
+        "symfony/runtime": "5.x-dev"
+    },
+    "require-dev": {
+        "symfony/phpunit-bridge": "^5.2"
+    },
+    "autoload": {
+        "psr-4": {
+            "Runtime\\PsrLaminas\\": "src/",
+            "Symfony\\Runtime\\Psr\\Http\\": "runtime/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Runtime\\PsrLaminas\\Tests\\": "tests/"
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}

phpunit.xml.dist

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
+         backupGlobals="false"
+         colors="true"
+         bootstrap="vendor/autoload.php"
+         failOnRisky="true"
+         failOnWarning="true"
+>
+  <php>
+    <ini name="error_reporting" value="-1"/>
+  </php>
+  <testsuites>
+    <testsuite name="Test Suite">
+      <directory>./tests</directory>
+      <directory suffix=".phpt">./tests/phpt</directory>
+    </testsuite>
+  </testsuites>
+</phpunit>

runtime/Message/ResponseInterfaceRuntime.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Symfony\Runtime\Psr\Http\Message;
+
+use Runtime\PsrLaminas\Runtime;
+
+class ResponseInterfaceRuntime extends Runtime
+{
+}

runtime/Message/ServerRequestInterfaceRuntime.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Symfony\Runtime\Psr\Http\Message;
+
+use Runtime\PsrLaminas\Runtime;
+
+class ServerRequestInterfaceRuntime extends Runtime
+{
+}

runtime/Server/RequestHandlerInterfaceRuntime.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Symfony\Runtime\Psr\Http\Server;
+
+use Runtime\PsrLaminas\Runtime;
+
+class RequestHandlerInterfaceRuntime extends Runtime
+{
+}

src/Emitter.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Runtime\PsrLaminas;
+
+use Laminas\HttpHandlerRunner\Emitter\SapiEmitter;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Server\RequestHandlerInterface;
+use Symfony\Component\Runtime\RunnerInterface;
+
+/**
+ * @author Tobias Nyholm <[email protected]>
+ */
+class Emitter implements RunnerInterface
+{
+    private $requestHandler;
+    private $response;
+    private $request;
+    private $emitter;
+
+    private function __construct(array $options)
+    {
+        $class = $options['emitter'] ?? SapiEmitter::class;
+
+        if (!class_exists($class)) {
+            throw new \LogicException(sprintf('The class "%s" cannot be found.', $class));
+        }
+
+        $this->emitter = new $class();
+    }
+
+    /**
+     * @param array{emitter?: ?string} $options
+     */
+    public static function createForResponse(ResponseInterface $response, array $options): self
+    {
+        $emitter = new self($options);
+        $emitter->response = $response;
+
+        return $emitter;
+    }
+
+    /**
+     * @param array{emitter?: ?string} $options
+     */
+    public static function createForRequestHandler(RequestHandlerInterface $handler, ServerRequestInterface $request, array $options): self
+    {
+        $emitter = new self($options);
+        $emitter->requestHandler = $handler;
+        $emitter->request = $request;
+
+        return $emitter;
+    }
+
+    public function run(): int
+    {
+        if (null === $this->response) {
+            $this->response = $this->requestHandler->handle($this->request);
+        }
+
+        $this->emitter->emit($this->response);
+
+        return 0;
+    }
+}