Add default response header support

CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [4.2.0] 2018-10
+
+### Added
+- Allow adding default response headers to strategies.
+
 ## [4.1.1] 2018-10
 
 ### Fixed

src/Strategy/AbstractStrategy.php

@@ -0,0 +1,69 @@
+<?php declare(strict_types=1);
+
+namespace League\Route\Strategy;
+
+use Psr\Http\Message\ResponseInterface;
+
+abstract class AbstractStrategy implements StrategyInterface
+{
+    /** @var array */
+    protected $defaultResponseHeaders = [];
+
+    /**
+     * Get current default response headers
+     *
+     * @return array
+     */
+    public function getDefaultResponseHeaders() : array
+    {
+        return $this->defaultResponseHeaders;
+    }
+
+    /**
+     * Add or replace a default response header
+     *
+     * @param string $name
+     * @param string $value
+     * @return static
+     */
+    public function addDefaultResponseHeader(string $name, string $value) : AbstractStrategy
+    {
+        $this->defaultResponseHeaders[strtolower($name)] = $value;
+
+        return $this;
+    }
+
+    /**
+     * Add multiple default response headers
+     *
+     * @param array $headers
+     * @return static
+     */
+    public function addDefaultResponseHeaders(array $headers) : AbstractStrategy
+    {
+        foreach ($headers as $name => $value) {
+            $this->addDefaultResponseHeader($name, $value);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Apply default response headers
+     *
+     * Headers that already exist on the response will NOT be replaced.
+     *
+     * @param \Psr\Http\Message\ResponseInterface $response
+     * @return \Psr\Http\Message\ResponseInterface
+     */
+    protected function applyDefaultResponseHeaders(ResponseInterface $response) : ResponseInterface
+    {
+        foreach ($this->defaultResponseHeaders as $name => $value) {
+            if (! $response->hasHeader($name)) {
+                $response = $response->withHeader($name, $value);
+            }
+        }
+
+        return $response;
+    }
+}

src/Strategy/ApplicationStrategy.php

@@ -9,7 +9,7 @@
 use Psr\Http\Message\{ResponseInterface, ServerRequestInterface};
 use Psr\Http\Server\{MiddlewareInterface, RequestHandlerInterface};
 
-class ApplicationStrategy implements ContainerAwareInterface, StrategyInterface
+class ApplicationStrategy extends AbstractStrategy implements ContainerAwareInterface
 {
     use ContainerAwareTrait;
 
@@ -19,7 +19,11 @@ class ApplicationStrategy implements ContainerAwareInterface, StrategyInterface
     public function invokeRouteCallable(Route $route, ServerRequestInterface $request) : ResponseInterface
     {
         $controller = $route->getCallable($this->getContainer());
-        return $controller($request, $route->getVars());
+
+        $response = $controller($request, $route->getVars());
+        $response = $this->applyDefaultResponseHeaders($response);
+
+        return $response;
     }
 
     /**

src/Strategy/JsonStrategy.php

@@ -10,7 +10,7 @@
 use Psr\Http\Message\{ResponseFactoryInterface, ResponseInterface, ServerRequestInterface};
 use Psr\Http\Server\{MiddlewareInterface, RequestHandlerInterface};
 
-class JsonStrategy implements ContainerAwareInterface, StrategyInterface
+class JsonStrategy extends AbstractStrategy implements ContainerAwareInterface
 {
     use ContainerAwareTrait;
 
@@ -27,6 +27,8 @@ class JsonStrategy implements ContainerAwareInterface, StrategyInterface
     public function __construct(ResponseFactoryInterface $responseFactory)
     {
         $this->responseFactory = $responseFactory;
+
+        $this->addDefaultResponseHeader('content-type', 'application/json');
     }
 
     /**
@@ -39,14 +41,11 @@ public function invokeRouteCallable(Route $route, ServerRequestInterface $reques
 
         if ($this->isJsonEncodable($response)) {
             $body     = json_encode($response);
-            $response = $this->responseFactory->createResponse();
-            $response = $response->withStatus(200);
+            $response = $this->responseFactory->createResponse(200);
             $response->getBody()->write($body);
         }
 
-        if ($response instanceof ResponseInterface && ! $response->hasHeader('content-type')) {
-            $response = $response->withAddedHeader('content-type', 'application/json');
-        }
+        $response = $this->applyDefaultResponseHeaders($response);
 
         return $response;
     }

tests/DispatchIntegrationTest.php

@@ -711,12 +711,6 @@ public function testRouteStrategyOverridesGlobalStrategy()
             ->will($this->returnValue($uri))
         ;
 
-        $response
-            ->expects($this->once())
-            ->method('withStatus')
-            ->will($this->returnSelf())
-        ;
-
         $response
             ->expects($this->once())
             ->method('getBody')
@@ -725,7 +719,7 @@ public function testRouteStrategyOverridesGlobalStrategy()
 
         $response
             ->expects($this->once())
-            ->method('withAddedHeader')
+            ->method('withHeader')
             ->with($this->equalTo('content-type'), $this->equalTo('application/json'))
             ->will($this->returnSelf())
         ;
@@ -775,12 +769,6 @@ public function testRouteStrategyOverridesGroupStrategy()
             ->will($this->returnValue($uri))
         ;
 
-        $response
-            ->expects($this->once())
-            ->method('withStatus')
-            ->will($this->returnSelf())
-        ;
-
         $response
             ->expects($this->once())
             ->method('getBody')
@@ -789,7 +777,7 @@ public function testRouteStrategyOverridesGroupStrategy()
 
         $response
             ->expects($this->once())
-            ->method('withAddedHeader')
+            ->method('withHeader')
             ->with($this->equalTo('content-type'), $this->equalTo('application/json'))
             ->will($this->returnSelf())
         ;

tests/Strategy/ApplicationStrategyTest.php

@@ -11,6 +11,40 @@
 
 class ApplicationStrategyTest extends TestCase
 {
+    /**
+     * Asserts that the strategy includes default headers.
+     *
+     * @return void
+     */
+    public function testStrategyHasDefaultHeaders() : void
+    {
+        $strategy = new ApplicationStrategy();
+
+        $expectedHeaders = [];
+
+        $this->assertSame($expectedHeaders, $strategy->getDefaultResponseHeaders());
+    }
+
+    /**
+     * Asserts that the strategy default headers can be added to.
+     *
+     * @return void
+     */
+    public function testStrategyCanDefineAdditionalHeaders() : void
+    {
+        $strategy = new ApplicationStrategy();
+
+        $additionalHeaders = [
+            'cache-control' => 'no-cache',
+        ];
+
+        $strategy->addDefaultResponseHeaders($additionalHeaders);
+
+        $expectedHeaders = array_replace([], $additionalHeaders);
+
+        $this->assertSame($expectedHeaders, $strategy->getDefaultResponseHeaders());
+    }
+
     /**
      * Asserts that the strategy properly invokes the route callable
      *

tests/Strategy/JsonStrategyTest.php

@@ -13,6 +13,48 @@
 
 class JsonStrategyTest extends TestCase
 {
+    /**
+     * Asserts that the strategy includes default headers.
+     *
+     * @return void
+     */
+    public function testStrategyHasDefaultHeaders() : void
+    {
+        $factory = $this->createMock(ResponseFactoryInterface::class);
+
+        $strategy = new JsonStrategy($factory);
+
+        $expectedHeaders = [
+            'content-type' => 'application/json',
+        ];
+
+        $this->assertSame($expectedHeaders, $strategy->getDefaultResponseHeaders());
+    }
+
+    /**
+     * Asserts that the strategy default headers can be added to.
+     *
+     * @return void
+     */
+    public function testStrategyCanDefineAdditionalHeaders() : void
+    {
+        $factory = $this->createMock(ResponseFactoryInterface::class);
+
+        $strategy = new JsonStrategy($factory);
+
+        $additionalHeaders = [
+            'cache-control' => 'no-cache',
+        ];
+
+        $strategy->addDefaultResponseHeaders($additionalHeaders);
+
+        $expectedHeaders = array_replace([
+            'content-type' => 'application/json',
+        ], $additionalHeaders);
+
+        $this->assertSame($expectedHeaders, $strategy->getDefaultResponseHeaders());
+    }
+
     /**
      * Asserts that the strategy properly invokes the route callable.
      *
@@ -53,7 +95,7 @@ function (
 
         $expectedResponse
             ->expects($this->once())
-            ->method('withAddedHeader')
+            ->method('withHeader')
             ->with($this->equalTo('content-type'), $this->equalTo('application/json'))
             ->will($this->returnSelf())
         ;
@@ -88,18 +130,11 @@ public function testStrategyInvokesRouteCallableWithArrayReturn() : void
 
         $expectedResponse
             ->expects($this->once())
-            ->method('withAddedHeader')
+            ->method('withHeader')
             ->with($this->equalTo('content-type'), $this->equalTo('application/json'))
             ->will($this->returnSelf())
         ;
 
-        $expectedResponse
-            ->expects($this->once())
-            ->method('withStatus')
-            ->with($this->equalTo(200))
-            ->will($this->returnSelf())
-        ;
-
         $expectedResponse
             ->expects($this->once())
             ->method('hasHeader')
@@ -359,18 +394,11 @@ public function testStrategyInvokesRouteCallableWithObjectReturn() : void
 
         $expectedResponse
             ->expects($this->once())
-            ->method('withAddedHeader')
+            ->method('withHeader')
             ->with($this->equalTo('content-type'), $this->equalTo('application/json'))
             ->will($this->returnSelf())
         ;
 
-        $expectedResponse
-            ->expects($this->once())
-            ->method('withStatus')
-            ->with($this->equalTo(200))
-            ->will($this->returnSelf())
-        ;
-
         $expectedResponse
             ->expects($this->once())
             ->method('hasHeader')
@@ -399,7 +427,6 @@ function (
                     $this->assertSame($expectedRequest, $request);
                     return $expectedObject;
                 }
-
             ))
         ;