Как закодировать имя файла UTF8 для заголовков HTTP? (Питон, Джанго)

Это часто задаваемые вопросы.

Нет никакого функционального способа сделать это. Некоторые браузеры реализуют проприетарные расширения (IE, Chrome), другие реализуют RFC 2231 (Firefox, Opera).

См. тестовые примеры по адресу http://greenbytes.de/tech/tc2231/.

Обновление: по состоянию на ноябрь 2012 г. все текущие настольные браузеры поддерживают кодировку, определенную в RFC 6266 и RFC 5987 (Safari >= 6, IE >= 9, Chrome, Firefox, Opera, Konqueror).

Не отправляйте имя файла в Content-Disposition. Невозможно заставить параметры заголовка, отличные от ASCII, работать в разных браузерах (*).

Вместо этого отправьте просто «Content-Disposition: вложение» и оставьте имя файла в виде строки UTF-8 в кодировке URL-адреса в конце (PATH_INFO) вашего URL-адреса, чтобы браузер мог подобрать и использовать его по умолчанию. URL-адреса UTF-8 обрабатываются браузерами гораздо надежнее, чем что-либо, связанное с Content-Disposition.

(*: на самом деле, нет даже действующего стандарта, который бы говорил, как это следует делать, так как взаимосвязь между RFC 2616, 2231 и 2047 довольно нефункциональна, что Джулиан пытается прояснить в ближайшее время. уровне спецификации.Постоянная поддержка браузеров ожидается в отдаленном будущем.)

Обратите внимание, что в 2011 году RFC 6266 (особенно Приложение D) взвешивал этот вопрос. и имеет конкретные рекомендации для подражания.

А именно, вы можете ввести filename только с символами ASCII, за которым следует filename* с именем файла в формате RFC 5987 для тех агентов, которые его понимают.

Обычно это будет выглядеть как filename="my-resume.pdf"; filename*=UTF-8''My%20R%C3%A9sum%C3%A9.pdf, где имя файла Unicode ("My Résumé.pdf") закодировано в UTF-8, а затем закодировано в процентах (обратите внимание, НЕ используйте + для пробелов).

Пожалуйста, действительно прочитайте RFC 6266 и RFC 5987 (или используйте надежную и проверенную библиотеку, которая абстрагирует это для вас), так как в моем резюме здесь отсутствуют важные детали.

Начиная с Django 2.1 (см. выпуск #16470), вы можете используйте FileResponse, который правильно установит Content-Disposition заголовок для вложений. Начиная с Django 3.0 (выпуск #30196), он также устанавливает это правильно для inline файлов.

Например, чтобы вернуть файл с именем my_img.jpg с типом MIME image/jpeg в качестве ответа HTTP:

response = FileResponse(open("my_img.jpg", 'rb'), as_attachment=True, content_type="image/jpeg")
return response

Или, если вы не можете использовать FileResponse, вы можете использовать соответствующую часть из источник FileResponse, чтобы самостоятельно установить заголовок Content-Disposition. Вот как сейчас выглядит этот источник:

from urllib.parse import quote

disposition = 'attachment' if as_attachment else 'inline'
try:
    filename.encode('ascii')
    file_expr = 'filename="{}"'.format(filename)
except UnicodeEncodeError:
    file_expr = "filename*=utf-8''{}".format(quote(filename))
response.headers['Content-Disposition'] = '{}; {}'.format(disposition, file_expr)

Могу сказать, что мне удалось успешно использовать более новый (RFC 5987) формат указания заголовка. закодировано с помощью формы электронной почты (RFC 2231). Я придумал следующее решение, основанное на коде из проекта django-sendfile.

import unicodedata
from django.utils.http import urlquote

def rfc5987_content_disposition(file_name):
    ascii_name = unicodedata.normalize('NFKD', file_name).encode('ascii','ignore').decode()
    header = 'attachment; filename="{}"'.format(ascii_name)
    if ascii_name != file_name:
        quoted_name = urlquote(file_name)
        header += '; filename*=UTF-8\'\'{}'.format(quoted_name)

    return header

# e.g.
  # request['Content-Disposition'] = rfc5987_content_disposition(file_name)

Я тестировал свой код только на Python 3.4 с Django 1.8. Таким образом, аналогичное решение в django-sendfile может подходит вам лучше.

В трекере Django есть давно действующий тикет, который признает это, но никаких исправлений пока не предложено. Так что, к сожалению, это настолько близко к использованию надежной протестированной библиотеки, насколько я смог найти, пожалуйста, дайте мне знать, если есть лучшее решение.

Взлом:

if (Request.UserAgent.Contains("IE"))
{
  // IE will accept URL encoding, but spaces don't need to be, and since they're so common..
  filename = filename.Replace("%", "%25").Replace(";", "%3B").Replace("#", "%23").Replace("&", "%26");
}