Add message, stream and URI factories for Slim Framework

.travis.yml

@@ -35,6 +35,9 @@ before_install:
 install:
     - travis_retry composer update ${COMPOSER_FLAGS} --prefer-dist --no-interaction
 
+before_script:
+    - if [[ "${TRAVIS_PHP_VERSION}" == "5.4" ]]; then composer remove slim/slim; fi
+
 script:
     - $TEST_COMMAND
 

composer.json

@@ -14,19 +14,22 @@
         "php": ">=5.4",
         "psr/http-message": "^1.0",
         "php-http/message-factory": "^1.0.2",
-        "clue/stream-filter": "^1.3"
+        "clue/stream-filter": "^1.3",
+        "slim/slim": "^3.5"
     },
     "require-dev": {
         "zendframework/zend-diactoros": "^1.0",
         "guzzlehttp/psr7": "^1.0",
         "ext-zlib": "*",
         "phpspec/phpspec": "^2.4",
         "henrikbjorn/phpspec-code-coverage" : "^1.0",
-        "coduo/phpspec-data-provider-extension": "^1.0"
+        "coduo/phpspec-data-provider-extension": "^1.0",
+        "akeneo/phpspec-skip-example-extension": "^1.0"
     },
     "suggest": {
         "zendframework/zend-diactoros": "Used with Diactoros Factories",
         "guzzlehttp/psr7": "Used with Guzzle PSR-7 Factories",
+        "slim/slim": "Used with Slim Factories",
         "ext-zlib": "Used with compressor/decompressor streams"
     },
     "autoload": {

phpspec.ci.yml

@@ -6,6 +6,7 @@ formatter.name: pretty
 extensions:
     - PhpSpec\Extension\CodeCoverageExtension
     - Coduo\PhpSpec\DataProvider\DataProviderExtension
+    - Akeneo\SkipExampleExtension
 code_coverage:
     format: clover
     output: build/coverage.xml

phpspec.yml.dist

@@ -5,3 +5,4 @@ suites:
 formatter.name: pretty
 extensions:
     - Coduo\PhpSpec\DataProvider\DataProviderExtension
+    - Akeneo\SkipExampleExtension

spec/MessageFactory/SlimMessageFactorySpec.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace spec\Http\Message\MessageFactory;
+
+use PhpSpec\ObjectBehavior;
+
+/**
+ * @require Slim\Http\Request
+ */
+class SlimMessageFactorySpec extends ObjectBehavior
+{
+    use MessageFactoryBehavior;
+
+    function it_is_initializable()
+    {
+        $this->shouldHaveType('Http\Message\MessageFactory\SlimMessageFactory');
+    }
+}

spec/StreamFactory/SlimStreamFactorySpec.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace spec\Http\Message\StreamFactory;
+
+use Slim\Http\Stream;
+use PhpSpec\ObjectBehavior;
+
+/**
+ * @require Slim\Http\Stream
+ */
+class SlimStreamFactorySpec extends ObjectBehavior
+{
+    use StreamFactoryBehavior;
+
+    function it_is_initializable()
+    {
+        $this->shouldHaveType('Http\Message\StreamFactory\SlimStreamFactory');
+    }
+
+    function it_creates_a_stream_from_stream()
+    {
+        $resource = fopen('php://memory', 'rw');
+        $this->createStream(new Stream($resource))
+            ->shouldHaveType('Psr\Http\Message\StreamInterface');
+    }
+}

spec/UriFactory/SlimUriFactorySpec.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace spec\Http\Message\UriFactory;
+
+use Psr\Http\Message\UriInterface;
+use PhpSpec\ObjectBehavior;
+
+/**
+ * @require Slim\Http\Uri
+ */
+class SlimUriFactorySpec extends ObjectBehavior
+{
+    use UriFactoryBehavior;
+
+    function it_is_initializable()
+    {
+        $this->shouldHaveType('Http\Message\UriFactory\SlimUriFactory');
+    }
+
+    /**
+     * TODO: Remove this when https://github.com/phpspec/phpspec/issues/825 is resolved
+     */
+    function it_creates_a_uri_from_uri(UriInterface $uri)
+    {
+        $this->createUri($uri)->shouldReturn($uri);
+    }
+}

src/MessageFactory/SlimMessageFactory.php

@@ -0,0 +1,72 @@
+<?php
+
+namespace Http\Message\MessageFactory;
+
+use Http\Message\StreamFactory\SlimStreamFactory;
+use Http\Message\UriFactory\SlimUriFactory;
+use Http\Message\MessageFactory;
+use Slim\Http\Request;
+use Slim\Http\Response;
+use Slim\Http\Headers;
+
+/**
+ * Creates Slim 3 messages.
+ *
+ * @author Mika Tuupola <[email protected]>
+ */
+final class SlimMessageFactory implements MessageFactory
+{
+    /**
+     * @var SlimStreamFactory
+     */
+    private $streamFactory;
+
+    /**
+     * @var SlimUriFactory
+     */
+    private $uriFactory;
+
+    public function __construct()
+    {
+        $this->streamFactory = new SlimStreamFactory();
+        $this->uriFactory = new SlimUriFactory();
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function createRequest(
+        $method,
+        $uri,
+        array $headers = [],
+        $body = null,
+        $protocolVersion = '1.1'
+    ) {
+        return (new Request(
+            $method,
+            $this->uriFactory->createUri($uri),
+            new Headers($headers),
+            [],
+            [],
+            $this->streamFactory->createStream($body),
+            []
+        ))->withProtocolVersion($protocolVersion);
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function createResponse(
+        $statusCode = 200,
+        $reasonPhrase = null,
+        array $headers = [],
+        $body = null,
+        $protocolVersion = '1.1'
+    ) {
+        return (new Response(
+            $statusCode,
+            new Headers($headers),
+            $this->streamFactory->createStream($body)
+        ))->withProtocolVersion($protocolVersion);
+    }
+}

src/StreamFactory/SlimStreamFactory.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Http\Message\StreamFactory;
+
+use Http\Message\StreamFactory;
+use Psr\Http\Message\StreamInterface;
+use Slim\Http\Stream;
+
+/**
+ * Creates Slim 3 streams.
+ *
+ * @author Mika Tuupola <[email protected]>
+ */
+final class SlimStreamFactory implements StreamFactory
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function createStream($body = null)
+    {
+        if ($body instanceof StreamInterface) {
+            return $body;
+        }
+
+        if (is_resource($body)) {
+            $stream = new Stream($body);
+        } else {
+            $resource = fopen('php://memory', 'rw');
+            $stream = new Stream($resource);
+
+            if (null !== $body) {
+                $stream->write((string) $body);
+            }
+        }
+
+        $stream->rewind();
+
+        return $stream;
+    }
+}

src/UriFactory/SlimUriFactory.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Http\Message\UriFactory;
+
+use Http\Message\UriFactory;
+use Psr\Http\Message\UriInterface;
+use Slim\Http\Uri;
+
+/**
+ * Creates Slim 3 URI.
+ *
+ * @author Mika Tuupola <[email protected]>
+ */
+final class SlimUriFactory implements UriFactory
+{
+    /**
+     * {@inheritdoc}
+     */
+    public function createUri($uri)
+    {
+        if ($uri instanceof UriInterface) {
+            return $uri;
+        }
+
+        if (is_string($uri)) {
+            return Uri::createFromString($uri);
+        }
+
+        throw new \InvalidArgumentException('URI must be a string or UriInterface');
+    }
+}