4.x - Improve AppFactory & ServerRequestCreatorFactory Automatic Decoration

[l0gicgate]

AppFactory's New Behavior
AppFactory will attempt to decorate ResponseFactory instances passed via AppFactory::create() or set via AppFactory::setResponseFactory() given that a StreamFactoryInterface has been set via AppFactory::setStreamFactory() given that Slim\Http is present.

Note that the AppFactory setters will override any of the PSR-17 factory provider automatically detected implementations.

<?php
use Slim\Factory\AppFactory;
use Your\Psr7\CustomResponseFactory;
use Your\Psr7\CustomStreamFactory;

// Set your custom StreamFactory first
$myStreamFactory = new CustomStreamFactory();
AppFactory::setStreamFactory($myStreamFactory);

// You can use a setter for your ResponseFactory
$myCustomResponseFactory = new CustomResponseFactory();
AppFactory::setResponseFactory($myCustomResponseFactory);
$app = AppFactory::create();

// Or you can use the AppFactory::create() constructor parameter
$app = AppFactory::create($myCustomResponseFactory);

ServerRequestCreatorFactory's New Behavior
Similarly to AppFactory you can set a default ServerRequestCreator which implements ServerRequestCreatorInterface that will override the automatically detected server request creators present in the PSR-17 factory provider.

<?php
use Slim\Factory\AppFactory;
use Slim\Factory\ServerRequestCreatorFactory;
use Your\Psr7\CustomServerRequestCreator;

$myCustomServerRequestCreator = new CustomServerRequestCreator();
ServerRequestCreatorFactory::setServerRequestCreator($myCustomServerRequestCreator);

$app = AppFactory::create();
$app->run();

This PR effectively closes #2709, #2710, #2712 and #2713

[coveralls]

Coverage remained the same at 100.0% when pulling 22f7157 on l0gicgate:4.x-ImproveAutomaticDecoration into 8dfa32d on slimphp:4.x.

[adriansuter]

Cool.