159 response redirect (#160)

* feature: response redirect/reload
for #159

* refactor: set callable after construction

* refactor: type improvement

* feature: pass status code on redirect

Author: Greg Bowler

composer.json

@@ -7,7 +7,7 @@
 		"php": ">=8.0",
 		"phpgt/input": "^v1",
 		"psr/http-message": "^v1.0.1",
-		"willdurand/negotiation": "v3.1.*"
+		"willdurand/negotiation": "v3.1.0"
 	},
 	"require-dev": {
 		"phpstan/phpstan": "v1.8.1",

composer.lock

@@ -2,26 +2,44 @@
 namespace Gt\Http;
 
 use Gt\Http\Header\ResponseHeaders;
+use Psr\Http\Message\RequestInterface;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\StreamInterface;
+use Psr\Http\Message\UriInterface;
 
 /**
  * @property ResponseHeaders $headers
  */
 class Response implements ResponseInterface {
 	use Message;
 
-	protected ?int $statusCode;
+	/** @var null|callable */
+	protected $exitCallback;
 
 	public function __construct(
-		int $status = null,
-		ResponseHeaders $headers = null
+		private ?int $statusCode = null,
+		ResponseHeaders $headers = null,
 	) {
-		$this->statusCode = $status;
 		$this->headers = $headers ?? new ResponseHeaders();
 		$this->stream = new Stream();
 	}
 
+	public function setExitCallback(callable $callback):void {
+		$this->exitCallback = $callback;
+	}
+
+	public function reload():void {
+		$this->redirect("./");
+	}
+
+	public function redirect(string|UriInterface $uri, int $statusCode = 303):void {
+		$this->statusCode = $statusCode;
+		$this->headers->set("Location", $uri);
+		if(isset($this->exitCallback)) {
+			call_user_func($this->exitCallback);
+		}
+	}
+
 	/**
 	 * Gets the response status code.
 	 *

src/Response.php

@@ -36,4 +36,23 @@ public function testGetResponseHeadersDefault() {
 		self::assertInstanceOf(ResponseHeaders::class, $headers);
 		self::assertCount(0, $headers);
 	}
-}
+
+	public function testRedirect() {
+		$callbackCount = 0;
+		$callback = function()use(&$callbackCount) {
+			$callbackCount++;
+		};
+
+		$sut = new Response(200);
+		$sut->setExitCallback($callback);
+
+		self::assertSame(0, $callbackCount);
+		$sut->redirect("/somewhere/");
+		self::assertSame(1, $callbackCount);
+
+		self::assertSame(
+			"/somewhere/",
+			$sut->getHeaderLine("Location")
+		);
+	}
+}