added Response::sendAsFile()

Author: dg

src/Http/Response.php

@@ -138,6 +138,22 @@ public function setContentType(string $type, string $charset = null)
 	}
 
 
+	/**
+	 * Response should be downloaded with 'Save as' dialog.
+	 * @return static
+	 * @throws Nette\InvalidStateException  if HTTP headers have been sent
+	 */
+	public function sendAsFile(string $fileName)
+	{
+		$this->setHeader(
+			'Content-Disposition',
+			'attachment; filename="' . str_replace('"', '', $fileName) . '"; '
+			. "filename*=utf-8''" . rawurlencode($fileName)
+		);
+		return $this;
+	}
+
+
 	/**
 	 * Redirects to another URL. Don't forget to quit the script then.
 	 * @throws Nette\InvalidStateException  if HTTP headers have been sent

tests/Http/Response.sendAsFile.phpt

@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * Test: Nette\Http\Response::sendAsFile().
+ */
+
+declare(strict_types=1);
+
+use Nette\Http;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+if (PHP_SAPI === 'cli') {
+	Tester\Environment::skip('Headers are not available in CLI');
+}
+
+
+$response = new Http\Response;
+
+$old = headers_list();
+$response->sendAsFile('file.name');
+$headers = array_values(array_diff(headers_list(), $old));
+Assert::same([
+	'Content-Disposition: attachment; filename="file.name"; filename*=utf-8\'\'file.name',
+], $headers);
+
+
+$old = headers_list();
+$response->sendAsFile('žluťoučký"\' name');
+$headers = array_values(array_diff(headers_list(), $old));
+Assert::same([
+	'Content-Disposition: attachment; filename="žluťoučký\' name"; filename*=utf-8\'\'%C5%BElu%C5%A5ou%C4%8Dk%C3%BD%22%27%20name',
+], $headers);