mirror of
https://github.com/nextcloud/server.git
synced 2026-04-26 00:27:49 -04:00
40 lines
1.4 KiB
PHP
40 lines
1.4 KiB
PHP
<?php
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors
|
|
* SPDX-FileCopyrightText: 2016 ownCloud, Inc.
|
|
* SPDX-License-Identifier: AGPL-3.0-only
|
|
*/
|
|
namespace OCP\AppFramework\Http;
|
|
|
|
use OCP\AppFramework\Http;
|
|
use Symfony\Component\HttpFoundation\HeaderUtils;
|
|
|
|
/**
|
|
* Prompts the user to download the a file
|
|
* @since 7.0.0
|
|
* @template-covariant S of Http::STATUS_*
|
|
* @template-covariant C of string
|
|
* @template-covariant H of array<string, mixed>
|
|
* @template-extends Response<Http::STATUS_*, array<string, mixed>>
|
|
*/
|
|
class DownloadResponse extends Response {
|
|
/**
|
|
* Creates a response that prompts the user to download the file
|
|
* @param string $filename the name that the downloaded file should have
|
|
* @param C $contentType the mimetype that the downloaded file should have
|
|
* @param S $status
|
|
* @param H $headers
|
|
* @since 7.0.0
|
|
*/
|
|
public function __construct(string $filename, string $contentType, int $status = Http::STATUS_OK, array $headers = []) {
|
|
parent::__construct($status, $headers);
|
|
|
|
$sanitized = str_replace(['/', '\\'], '-', $filename);
|
|
$fallback = @iconv('UTF-8', 'ASCII//TRANSLIT', $sanitized) ?: $sanitized;
|
|
$fallback = preg_replace('/[^\x20-\x7e]/', '', $fallback);
|
|
$fallback = str_replace('%', '', $fallback);
|
|
$this->addHeader('Content-Disposition', HeaderUtils::makeDisposition(HeaderUtils::DISPOSITION_ATTACHMENT, $sanitized, $fallback));
|
|
$this->addHeader('Content-Type', $contentType);
|
|
}
|
|
}
|