PSR-7 Decorators Migration

[l0gicgate]

PSR-7 Decorators

This PR is to migrate the Slim-Http repo to a decoration library for PSR-7 objects instead of a PSR-7 Implementation as discussed in #66. The will be a PR on the Slim 4 branch to reflect these changes once this branch gets merged.

This will enable us to keep all of the existing functionality from the current Slim PSR-7 implementation that was Slim-Http but giving the end user flexibility as to what PSR-7 implementation they choose.

All the tests were written and tested with the following two PSR-7 Implementations:

• Nyholm/psr7
• Zend-Diactoros

The Decoration Repo Provides 3 Factories which instantiate the Decorators. They respectively return PSR-7 Compatible Interfaces

• DecoratedResponseFactory
• DecoratedServerRequestFactory
• DecoratedUriFactory

Example For Instantiating a Decorated Nyholm/Psr7 Response

<?php

use Nyholm\Psr7\Factory\Psr17Factory;
use SlimPsr7Decorators\Factory\DecoratedResponseFactory;

$nyholmFactory = new Psr17Factory();

/**
 * DecoratedResponseFactory takes 2 parameters
 * @param \Psr\Http\Message\ResponseFactoryInterface which should be a ResponseFactory originating from the PSR-7 Implementation of your choice
 * @param \Psr\Http\Message\StreamFactoryInterface which should be a StreamFactory originating from the PSR-7 Implementation of your choice
 * Note: Nyholm/Psr17 has one factory which implements Both ResponseFactoryInterface and StreamFactoryInterface see https://github.com/Nyholm/psr7/blob/master/src/Factory/Psr17Factory.php
 */
$decoratedResponseFactory = new DecoratedResponseFactory($nyholmFactory, $nyholmFactory);

/**
 * @var \SlimPsr7Decorators\Decorators\DecoratedResponse $response
 * The returned variable is a DecoratedResponse which has methods like withJson()
 */
$response = $decoratedResponseFactory->createResponse(200, 'OK');
$response = $response->withJson(['data' => [1, 2, 3]]);

Example For Instantiating a Decorated Zend Diactoros Response

<?php

use Zend\Diactoros\ResponseFactory;
use Zend\Diactoros\StreamFactory;
use SlimPsr7Decorators\Factory\DecoratedResponseFactory;

$responseFactory = new ResponseFactory();
$streamFactory = new StreamFactory();

/**
 * DecoratedResponseFactory takes 2 parameters
 * @param \Psr\Http\Message\ResponseFactoryInterface which should be a ResponseFactory originating from the PSR-7 Implementation of your choice
 * @param \Psr\Http\Message\StreamFactoryInterface which should be a StreamFactory originating from the PSR-7 Implementation of your choice
 */
$decoratedResponseFactory = new DecoratedResponseFactory($responseFactory, $streamFactory);

/**
 * @var \SlimPsr7Decorators\Decorators\DecoratedResponse $response
 * The returned variable is a DecoratedResponse which has methods like withJson()
 */
$response = $decoratedResponseFactory->createResponse(200, 'OK');
$response = $response->withJson(['data' => [1, 2, 3]]);

[coveralls]

Coverage increased (+2.2%) to 100.0% when pulling 6325430 on l0gicgate:Psr7-Decorators into 4c76c96 on slimphp:master.

[danopz]

Just did a quick review.

For UriDecorator it is the same as for the others.