feat(Response): add getRouterBinaryFileResponse() to serve files

src/Response.php

@@ -18,6 +18,11 @@ class Response
      */
     protected $content;
 
+    /**
+     * @var string
+     */
+    protected $file;
+
     /**
      * @var string
      */
@@ -62,6 +67,14 @@ public function __construct(RouterInterface $router, $format, $statusCode)
         $this->setStatusCode($statusCode);
     }
 
+    /**
+     * @param string
+     */
+    public function setFile($file)
+    {
+        $this->file = $file;
+    }
+
     /**
      * @return string
      */
@@ -226,7 +239,7 @@ public function getRouterResponse($autoSerializeContent = true)
         }
 
         return $this->router->getResponse(
-            $content, $this->getConfiguredHeaderstatusCode(), $this->getConfiguredHeaders()
+            $content, $this->getConfiguredHeaderstatusCode(), $this->getConfiguredHeaders(), $this->file
         );
     }
 

src/Router/RouterInterface.php

@@ -55,8 +55,9 @@ public function setPayloadBodyValue($payloadBodyJSON);
      * @param string   $content
      * @param int      $statusCode
      * @param string[] $headers
+     * @param string|null $file
      *
      * @return mixed
      */
-    public function getResponse($content = '', $statusCode = 200, $headers = array());
+    public function getResponse($content = '', $statusCode = 200, $headers = array(), $file = null);
 }

src/Router/Silex.php

@@ -2,6 +2,7 @@
 
 namespace RREST\Router;
 
+use Symfony\Component\HttpFoundation\BinaryFileResponse as HttpFoundationBinaryFileResponse;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response as HttpFoundationResponse;
 use RREST\Response;
@@ -111,8 +112,11 @@ public function setPayloadBodyValue($payloadBodyJSON)
     /**
      * {@inheritdoc}
      */
-    public function getResponse($content = '', $statusCode = 200, $headers = array())
+    public function getResponse($content = '', $statusCode = 200, $headers = array(), $file = null)
     {
+        if (!empty($file)) {
+            return new HttpFoundationBinaryFileResponse($file, $statusCode, $headers);
+        }
         return new HttpFoundationResponse($content, $statusCode, $headers);
     }
 }

tests/units/Response.php

@@ -215,4 +215,17 @@ public function testGetRouterResponse()
             ->isEqualTo('https://api.domain.com/items/uuid')
         ;
     }
+
+    public function testGetRouterResponseWithFile()
+    {
+        $this->newTestedInstance($this->router, 'json', 201);
+
+        $this
+            ->given($this->testedInstance)
+            ->and(
+                $this->testedInstance->setFile(__DIR__.'/../fixture/song.xml')
+            )
+            ->object($this->testedInstance->getRouterResponse())
+            ->isInstanceOf('Symfony\Component\HttpFoundation\BinaryFileResponse');
+    }
 }

tests/units/Router/Silex.php

@@ -54,6 +54,15 @@ public function testGetResponse()
             ->isInstanceOf('Symfony\Component\HttpFoundation\Response');
     }
 
+    public function testGetResponseWithFile()
+    {
+        $this->newTestedInstance($this->app);
+        $this
+            ->given($this->testedInstance)
+            ->object($this->testedInstance->getResponse('XXX', 200, [], __DIR__.'/../../fixture/song.xml'))
+            ->isInstanceOf('Symfony\Component\HttpFoundation\BinaryFileResponse');
+    }
+
     public function testGetPayloadBodyValue()
     {
         $this->newTestedInstance($this->app);