Merge cb21c21 into 26efe24

.travis.yml

@@ -26,36 +26,45 @@ matrix:
     - php: 7
       env:
         - DEPS=lowest
+        - INSTALL_SWOOLE=true
     - php: 7
       env:
         - DEPS=locked
         - CHECK_CS=true
         - TEST_COVERAGE=true
+        - INSTALL_SWOOLE=true
     - php: 7
       env:
         - DEPS=latest
+        - INSTALL_SWOOLE=true
     - php: 7.1
       env:
         - DEPS=lowest
+        - INSTALL_SWOOLE=true
     - php: 7.1
       env:
         - DEPS=locked
+        - INSTALL_SWOOLE=true
     - php: 7.1
       env:
         - DEPS=latest
+        - INSTALL_SWOOLE=true
     - php: 7.2
       env:
         - DEPS=lowest
+        - INSTALL_SWOOLE=true
     - php: 7.2
       env:
         - DEPS=locked
+        - INSTALL_SWOOLE=true
     - php: 7.2
       env:
         - DEPS=latest
+        - INSTALL_SWOOLE=true
 
 before_install:
   - if [[ $TEST_COVERAGE != 'true' && "$(php --version | grep xdebug -ci)" -ge 1 ]]; then phpenv config-rm xdebug.ini || return 0 ; fi
-  - travis_retry composer self-update
+  - if [[ $INSTALL_SWOOLE == 'true' ]]; then ./.travis/install_swoole.sh ; fi
 
 install:
   - travis_retry composer install $COMPOSER_ARGS --ignore-platform-reqs

.travis/install_swoole.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+pecl install swoole << EOF
+`#enable debug/trace log support? [no] :`
+`#enable sockets supports? [no] :`y
+`#enable openssl support? [no] :`
+`#enable http2 support? [no] :`
+`#enable async-redis support? [no] :`
+`#enable mysqlnd support? [no] :`
+`#enable postgresql coroutine client support? [no] :`
+EOF

doc/book/swoole.md

@@ -0,0 +1,54 @@
+# Swoole
+use Zend\Diactoros\ServerRequestFactory;
+
+[Swoole](https://www.swoole.co.uk/) is an async programming Framework for PHP
+that can be used to create high performance HTTP server applications, e.g. web
+APIs. We provided the support of Swoole in `zend-diactoros` using two methods to
+convert a [Swoole\Http\Request](http://php.net/manual/en/class.swoole-http-request.php)
+in a [PSR-7 Request](https://www.php-fig.org/psr/psr-7/#32-psrhttpmessagerequestinterface)
+and a [PSR-7 Response](https://www.php-fig.org/psr/psr-7/#33-psrhttpmessageresponseinterface)
+in a [Swoole\Http\Response](http://php.net/manual/en/class.swoole-http-response.php).
+
+To convert a Swoole request in PSR-7 we provided the following static function:
+
+```
+Zend\Diactoros\ServerRequestFactory::fromSwoole(swoole_http_request $request)
+```
+
+Where `$request` is an instance of `swoole_http_request` (alias of
+`Swoole\Http\Request`).
+
+To convert a PSR-7 response in a Swoole response we built a specific emitter,
+`Zend\Diactoros\Response\SwooleEmitter`. If you can use this emitter instead of
+`Zend\Diactoros\Response\SapiEmitter`.
+
+You need to instantiate the `SwooleEmitter` passing a `swoole_http_response`
+object in the constructor.
+
+You can execute Swoole with [Expressive](https://getexpressive.org/) using the
+following server implementation:
+
+```php
+use Zend\Diactoros\ServerRequestFactory;
+use Zend\Diactoros\Response\SwooleEmitter;
+
+$http = new swoole_http_server("127.0.0.1", 9501);
+
+$http->on("start", function ($server) {
+    echo "Swoole http server is started at http://127.0.0.1:9501\n";
+});
+
+// Bootstrap of zend-expressive
+$container = require 'config/container.php';
+$app = $container->get(\Zend\Expressive\Application::class);
+
+$http->on("request", function ($request, $response) use ($app) {
+    $psr7Request  = ServerRequestFactory::fromSwoole($request);
+    $psr7Response = $app->handle($psr7Request);
+
+    $emitter = new SwooleEmitter($response);
+    $emitter->emit($psr7Response);
+});
+
+$http->start();
+```

mkdocs.yml

@@ -10,6 +10,7 @@ pages:
         - "Emitting Responses": emitting-responses.md
         - Serialization: serialization.md
         - API: api.md
+        - Swoole: swoole.md
 site_name: zend-diactoros
 site_description: 'zend-diactoros: PSR-7 HTTP message implementation'
 repo_url: 'https://github.com/zendframework/zend-diactoros'

src/ServerRequestFactory.php

@@ -1,15 +1,17 @@
 <?php
 /**
  * @see       https://github.com/zendframework/zend-diactoros for the canonical source repository
- * @copyright Copyright (c) 2015-2017 Zend Technologies USA Inc. (http://www.zend.com)
+ * @copyright Copyright (c) 2015-2018 Zend Technologies USA Inc. (https://www.zend.com)
  * @license   https://github.com/zendframework/zend-diactoros/blob/master/LICENSE.md New BSD License
  */
 
 namespace Zend\Diactoros;
 
 use InvalidArgumentException;
 use Psr\Http\Message\UploadedFileInterface;
+use RuntimeException;
 use stdClass;
+use swoole_http_request;
 use UnexpectedValueException;
 
 use function array_change_key_case;
@@ -99,6 +101,52 @@ public static function fromGlobals(
         );
     }
 
+    /**
+     * Create a request from a Swoole request
+     *
+     * @param swoole_http_request $request
+     * @return ServerRequest
+     * @throws RuntimeException if Swoole is not installed
+     */
+
+    public static function fromSwoole(swoole_http_request $request)
+    {
+        if (! extension_loaded('swoole')) {
+            throw new Exception\RuntimeException('Swoole extension is not installed!');
+        }
+        $get    = isset($request->get) ? $request->get : [];
+        $post   = isset($request->post) ? $request->post : [];
+        $cookie = isset($request->cookie) ? $request->cookie : [];
+        $files  = isset($request->files) ? $request->files : [];
+
+        $server = [];
+        if (isset($request->server)) {
+            foreach ($request->server as $key => $value) {
+                $server[strtoupper($key)] = $value;
+            }
+        }
+
+        $headers = [];
+        if (isset($request->header)) {
+            foreach ($request->header as $name => $value) {
+                $headers[str_replace('-', '_', $name)] = $value;
+            }
+        }
+
+        return new ServerRequest(
+            $server,
+            static::normalizeFiles($files),
+            static::marshalUriFromServer($server, $headers),
+            $server['REQUEST_METHOD'] ?? 'GET',
+            new SwooleStream($request),
+            $headers,
+            $cookie,
+            $get,
+            $post,
+            static::marshalProtocolVersion($server)
+        );
+    }
+
     /**
      * Access a value in an array, returning a default value if not found
      *

src/SwooleStream.php

@@ -0,0 +1,189 @@
+<?php
+/**
+ * @see       https://github.com/zendframework/zend-diactoros for the canonical source repository
+ * @copyright Copyright (c) 2015-2017 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   https://github.com/zendframework/zend-diactoros/blob/master/LICENSE.md New BSD License
+ */
+
+namespace Zend\Diactoros;
+
+use Psr\Http\Message\StreamInterface;
+use RuntimeException;
+use swoole_http_request;
+
+class SwooleStream implements StreamInterface
+{
+    /**
+     * @var string
+     */
+    protected $body;
+
+    /**
+     * @var int
+     */
+    protected $bodySize;
+
+    /**
+     * @var int
+     */
+    protected $index = 0;
+
+    public function __construct(swoole_http_request $request)
+    {
+        $this->request = $request;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getContents()
+    {
+        if (! isset($this->body)) {
+            $this->body = $this->request->rawcontent();
+        }
+        return $this->body;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function __toString()
+    {
+        return $this->getContents();
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getSize()
+    {
+        if (! isset($this->bodySize)) {
+            $this->bodySize = strlen($this->getContents());
+        }
+        return $this->bodySize;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function tell()
+    {
+        return $this->index;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function eof()
+    {
+        return $this->index >= $this->getSize() - 1;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function isReadable()
+    {
+        return true;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function read($length)
+    {
+        $result = substr($this->getContents(), $this->index, $length);
+        $this->index += $length;
+        return $result;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function isSeekable()
+    {
+        return true;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function seek($offset, $whence = SEEK_SET)
+    {
+
+        switch ($whence) {
+            case SEEK_SET:
+                if ($offset >= $this->getSize()) {
+                    throw new RuntimeException(
+                        'Offset cannot be longer than content size'
+                    );
+                }
+                $this->index = $offset;
+                break;
+            case SEEK_CUR:
+                if ($offset + $this->index >= $this->getSize()) {
+                    throw new RuntimeException(
+                        'Offset + current position cannot be longer than content size'
+                    );
+                }
+                $this->index += $offset;
+                break;
+            case SEEK_END:
+                if ($offset + $this->getSize() >= $this->getSize()) {
+                    throw new RuntimeException(
+                        'Offset must be a negative number to be under the content size'
+                    );
+                }
+                $this->index = $this->getSize() - 1 + $offset;
+                break;
+        }
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function rewind()
+    {
+        $this->index = 0;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function isWritable()
+    {
+        return false;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function write($string)
+    {
+        throw new RuntimeException('Stream is not writable');
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function getMetadata($key = null)
+    {
+        return null;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function detach()
+    {
+        return null;
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function close()
+    {
+        return null;
+    }
+}