Заголовки на скачивание файла

bullgare — Mon, 18 Jan 2010 12:19:06 +0000

Чтобы при обращении по данному урлу браузер выдавал запрос на сохранение файла, нужно передать заголовки.
Для этого достаточно только одного заголовка
«Content-Disposition: attachment; filename=\»myfile.csv\»\r\n»

Но более полно код будет выглядеть так (взято из конкретного примера на php):

header("Content-Description: File Transfer\r\n");
header("Pragma: public\r\n");
header("Expires: 0\r\n");
header("Cache-Control: must-revalidate, post-check=0, pre-check=0\r\n");
header("Cache-Control: public\r\n");
header("Content-Type: text/plain; charset=UTF-8\r\n");
header("Content-Disposition: attachment; filename=\"myfile.csv\"\r\n");
echo 123321;

В итоге будет предложено скачать файл с названием по умолчанию myfile.csv.

Функция header в php

admin — Wed, 23 Sep 2009 09:47:28 +0000

Функция header в php используется для посылки HTTP-заголовков (почитать на w3.org).

void header  ( string $string  [, bool $replace = true  [, int $http_response_code  ]] )

$string:
сам заголовок. Бывает двух типов. Первый начинается с «HTTP/» (header(«HTTP/1.0 404 Not Found»);). Второй начинается не с «HTTP/». Состоит из двух частей «имя парметра: значение» (например, «Location: http://www.example.com/» или «Content-type: application/pdf»).
Второй параметр булевого типа. Если true (по умолчанию), то заголовок замещает предыдущий с таким же именем параметра, если false, то передаётся несколько параметров одного типа:

Третий параметр, $http_response_code, можно использовать для передачи HTTP-заголовков ответа (200, 404 и т.п.):

// 301 Moved Permanently
header("Location: /foo.php",TRUE,301);

// 302 Found
header("Location: /foo.php",TRUE,302); //это значение по умолчанию.
header("Location: /foo.php");//аналогично

// 303 See Other
header("Location: /foo.php",TRUE,303);

// 307 Temporary Redirect
header("Location: /foo.php",TRUE,307);

Функция header используется для простановки заголовков «вручную», для кеширования, для внешнего перенаправления, для выставления правильного mime-типа и кодировки.

Пример простановки заголовков «вручную»:

ob_start();
@header("HTTP/1.1 503 Service Temporarily Unavailable");
@header("Status: 503 Service Temporarily Unavailable");
@header("Retry-After: 120");
@header("Connection: Close");
?>

503 Service Temporarily Unavailable

Service Temporarily Unavailable
The server is temporarily unable to service your
request due to maintenance downtime or capacity
problems. Please try again later.

Пример внешнего перенаправления:
	public static function redirect($url = '/')
	{
		header('Location: ' . $url);
		die();
	}

Пример реализации скачивания файлов по расширению (полезен перечислением mime-типов):
"); break;

      default: $ctype="application/force-download";
    }

    //Begin writing headers
    header("Pragma: public");
    header("Expires: 0");
    header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
    header("Cache-Control: public");
    header("Content-Description: File Transfer");

    //Use the switch-generated Content-Type
    header("Content-Type: $ctype");

    //Force the download
    $header="Content-Disposition: attachment; filename=".$filename.";";
    header($header );
    header("Content-Transfer-Encoding: binary");
    header("Content-Length: ".$len);
    @readfile($file);
    exit;
}
?>

*Mime-типы описываются здесь.
Заголовок header(«Content-Transfer-Encoding: binary»); очень важен для того, чтобы заставить браузер скачивать файл, а не отображать текстовое содержимое.
Пример установки использумой кодировки:
	header('Content-type: text/html; charset=utf-8');
	header('Content-type: text/xml; charset=utf-8');

Самая интересная часть: кеширование (w3.org).

Для начала надо заметить, что HTTP/1.0 моежт не поддерживать основную директиву (Cache-Control), поэтому в этом случае нужно использовать заголовок Pragma: no-cache. Хотя уже давно все поддерживают 1.1, поэтому особого смысла это делать нет.

Заголовок Cache-Control может использоваться как для запроса, так и для ответа. Нас интересует только ответ.

Синтаксис следующий:

«Cache-Control: значение».

Значения:
"public" //может кешироваться всеми (прокси-серверами тоже)
"private" //может кешироваться клиентом
"no-cache" //должен кешироваться клиентом (есть ещё доп. параметры)
"no-store" //не сохранять на диске
"no-transform" //для прокси-серверов запрещает изменять тип файла (для картинок, к примеру)
"must-revalidate" //все должны подтвердить наличие кеша
"proxy-revalidate" //прокси должен подтвердить наличие кеша
"max-age" "=" delta-seconds //закешировать на это время
"s-maxage" "=" delta-seconds //для общего кеша (не private) переопределяет значение "max-age" и заголовок "Expires:"
Например:
Cache-Control: max-age=значение

Заголовок Expires используется для задания даты, при которой кеш считается просроченным

(Expires: Thu, 01 Dec 1994 16:00:00 GMT), можно задавать дату в прошлом (значит, кеш уже просрочен) или в будущем. При этом если используется заголовок Cache-Control: max-age=значение, то он переопределяет заголовок Expires.

Заголовок ETag используется для создания «тегов», по сравнению которых можно определить, актуален ли кеш в браузере/на прокси-сервере.

Использование:

ETag: уникальный тег.

Обычно для создания тегов советуют использовать что-то вроде:
$etag = md5_file($file);
header("Etag: $etag");

Думаю, для кеширования картинок вполне достаточно этого:
$etag = filesize($file);
header("Etag: $etag");

Но только делать такие вещи в том же Nginx (возможно там такой механизм уже есть).

Для запрета кеширования обычно используется связка
header("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1
header("Expires: Sat, 26 Jul 1997 05:00:00 GMT"); // Date in the past

Разработка » header

Заголовки на скачивание файла

Функция header в php

Service Temporarily Unavailable