Wie kodiere ich den Dateinamen-Parameter des Content-Disposition-Headers in HTTP?

Ich weiß, dies ist eine alte post, aber es ist immer noch sehr relevant. Ich habe festgestellt, dass moderne Browser unterstützen rfc5987, die können utf-8-Codierung, Prozentsatz-kodiert (url-encoded). Dann Naiv file.txt wird:

Content-Disposition: attachment; filename*=UTF-8''Na%C3%AFve%20file.txt

Safari (5) dies nicht unterstützt. Stattdessen sollten Sie die Safari-standard zu schreiben, den Namen der Datei direkt in Ihre utf-8-codierte header:

Content-Disposition: attachment; filename=Naïve file.txt

IE8 und älter nicht unterstützen, und Sie müssen, verwenden Sie den IE-standard utf-8-Codierung, Prozentsatz codiert werden:

Content-Disposition: attachment; filename=Na%C3%AFve%20file.txt

In ASP.Net ich verwende den folgenden code:

string contentDisposition;
if (Request.Browser.Browser == "IE" && (Request.Browser.Version == "7.0" || Request.Browser.Version == "8.0"))
    contentDisposition = "attachment; filename=" + Uri.EscapeDataString(fileName);
else if (Request.Browser.Browser == "Safari")
    contentDisposition = "attachment; filename=" + fileName;
else
    contentDisposition = "attachment; filename*=UTF-8''" + Uri.EscapeDataString(fileName);
Response.AddHeader("Content-Disposition", contentDisposition);

Getestet habe ich das oben mit IE7, IE8, IE9, Chrome 13, Opera 11, FF5, Safari 5.

Update November 2013:

Hier ist der code, den ich derzeit benutze. Ich habe noch zur Unterstützung des IE8, so dass ich nicht loswerden kann der erste Teil. Es stellt sich heraus, dass die Browser auf Android mit dem eingebauten Android-download-manager, und es kann nicht zuverlässig analysieren Dateinamen in den standard-Weg.

string contentDisposition;
if (Request.Browser.Browser == "IE" && (Request.Browser.Version == "7.0" || Request.Browser.Version == "8.0"))
    contentDisposition = "attachment; filename=" + Uri.EscapeDataString(fileName);
else if (Request.UserAgent != null && Request.UserAgent.ToLowerInvariant().Contains("android")) //android built-in download manager (all browsers on android)
    contentDisposition = "attachment; filename=\"" + MakeAndroidSafeFileName(fileName) + "\"";
else
    contentDisposition = "attachment; filename=\"" + fileName + "\"; filename*=UTF-8''" + Uri.EscapeDataString(fileName);
Response.AddHeader("Content-Disposition", contentDisposition);

Oben jetzt getestet im IE7-11, Chrome 32, Opera 12, FF25, Safari 6, verwenden diesen Dateinamen für den download: 你好abcABCæøåÆØÅäöüïëêîâéíáóúýñ½§!#¤%&()=`@£$€{[]}+^~'-_,;.txt

IE7 funktioniert es für einige Zeichen, aber nicht alle. Aber wer kümmert sich um den IE7 heute?

Dies ist die Funktion, die ich verwenden, um den sicheren Datei-Namen für Android. Beachten Sie, dass ich nicht weiß welche Zeichen werden unterstützt auf Android, aber, die ich getestet habe, dass diese sicher arbeiten:

private static readonly Dictionary<char, char> AndroidAllowedChars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ._-+,@£$€!½§~'=()[]{}0123456789".ToDictionary(c => c);
private string MakeAndroidSafeFileName(string fileName)
{
    char[] newFileName = fileName.ToCharArray();
    for (int i = 0; i < newFileName.Length; i++)
    {
        if (!AndroidAllowedChars.ContainsKey(newFileName[i]))
            newFileName[i] = '_';
    }
    return new string(newFileName);
}

@TomZ: ich habe das getestet in IE7 und IE8 und es stellte sich heraus, dass ich nicht brauchen, um zu entkommen apostrophe ('). Hast du ein Beispiel, wo es scheitert?

@Dave Van den Eynde: die Kombination der beiden Datei-Namen in einer Zeile als nach RFC6266 funktioniert, außer für Android und IE7+8 und ich habe aktualisiert, der code, um dies zu reflektieren. Danke für die Anregung.

@Thilo: Keine Ahnung, GoodReader oder einer anderen nicht-browser. Sie haben vielleicht einige Glück mit dem Android-Ansatz.

@Alex Zhukovskiy: ich weiß nicht warum, aber, wie besprochen, auf Verbinden es scheint nicht zu funktionieren sehr gut.

InformationsquelleAutor der Antwort Martin Ørding-Thomsen

RFC-6266 beschreibt die "die Verwendung des Content-Disposition-Header-Feld im HTTP (Hypertext Transfer Protocol)". Zitiert aus:

6. Internationalisierung Überlegungen

"filename*"- Parameter (Abschnitt 4.3), mit der Kodierung definiert
in [RFC5987], kann der server zum übertragen von Zeichen außerhalb des
ISO-8859-1-Zeichensatz um, und auch geben Optional die Sprache
in Verwendung.

Und in Ihrer im Abschnitt "Beispiele":

Diesem Beispiel ist die gleiche wie oben, aber das hinzufügen der "Dateiname"
parameter für die Kompatibilität mit Benutzeragenten, nicht die Umsetzung
RFC 5987:

Content-Disposition: attachment;
                     filename="EURO rates";
                     filename*=utf-8''%e2%82%ac%20rates

Hinweis: Die user-agents, die keine Unterstützung für die RFC 5987 Codierung
ignorieren "filename*" wenn es Auftritt, nach "filename".

In Anhang D es gibt auch eine lange Liste von Vorschlägen, um die Interoperabilität zu erhöhen. Es verweist auch auf eine Website vergleicht Implementierungen. Aktuelle all-pass-tests geeignet für die gemeinsame Datei-Namen sind:

• attwithisofnplain: plain ISO-8859-1-Datei-Namen, die mit doppelten Anführungszeichen und ohne Codierung. Dies erfordert einen Dateinamen, die alle ISO-8859-1 und nicht enthalten Prozent-Zeichen, zumindest nicht vor der hex-Ziffern.
• attfnboth: zwei Parameter in der oben beschriebenen Reihenfolge. Sollten für die meisten Datei-Namen, die auf den meisten Browsern, obwohl IE8 verwenden die " filename " - parameter.

Dass RFC 5987 wiederum Verweise RFC 2231die beschreibt das eigentliche format. 2231 ist in Erster Linie für E-mail und 5987 sagt uns, welche Teile verwendet werden können, für HTTP-Header als gut. Verwechseln Sie dies nicht mit MIME-Headern verwendet, innen ein multipart/form-data HTTP Körperdie regiert wird von RFC 2388 (Abschnitt 4.4 im besonderen) und die HTML-5-Entwurf.

InformationsquelleAutor der Antwort MvG

in asp.net mvc2 ich so etwas wie dieses:

return File(
    tempFile
    , "application/octet-stream"
    , HttpUtility.UrlPathEncode(fileName)
    );

Ich denke, wenn Sie es nicht verwenden, mvc(2), konnte man nur codieren, die mit dem Namen mit

HttpUtility.UrlPathEncode(fileName)

InformationsquelleAutor der Antwort Elmer

In ASP.NET Web-API, ich url-codieren, die mit dem Namen:

public static class HttpRequestMessageExtensions
{
    public static HttpResponseMessage CreateFileResponse(this HttpRequestMessage request, byte[] data, string filename, string mediaType)
    {
        HttpResponseMessage response = new HttpResponseMessage(HttpStatusCode.OK);
        var stream = new MemoryStream(data);
        stream.Position = 0;

        response.Content = new StreamContent(stream);

        response.Content.Headers.ContentType = 
            new MediaTypeHeaderValue(mediaType);

        //URL-Encode filename
        //Fixes behavior in IE, that filenames with non US-ASCII characters
        //stay correct (not "_utf-8_.......=_=").
        var encodedFilename = HttpUtility.UrlEncode(filename, Encoding.UTF8);

        response.Content.Headers.ContentDisposition =
            new ContentDispositionHeaderValue("attachment") { FileName = encodedFilename };
        return response;
    }
}

InformationsquelleAutor der Antwort martinoss

Getestet habe ich den folgenden code in allen gängigen Browsern, einschließlich älterer Explorers (über den compatibility mode), und es funktioniert überall gut:

$filename = $_GET['file']; //this string from $_GET is already decoded
if (strstr($_SERVER['HTTP_USER_AGENT'],"MSIE"))
  $filename = rawurlencode($filename);
header('Content-Disposition: attachment; filename="'.$filename.'"');

InformationsquelleAutor der Antwort Stano

Landete ich mit dem folgenden code in meine "download.php" Skript (basierend auf dieser Beitrag und diese Testfälle).

$il1_filename = utf8_decode($filename);
$to_underscore = "\"\\#*;:|<>/?";
$safe_filename = strtr($il1_filename, $to_underscore, str_repeat("_", strlen($to_underscore)));

header("Content-Disposition: attachment; filename=\"$safe_filename\""
.( $safe_filename === $filename ? "" : "; filename*=UTF-8''".rawurlencode($filename) ));

Diese nutzt die standard-Weg, filename="..." solange es sind nur iso-latin1 und der "safe" - Zeichen verwendet; wenn nicht, dann wird der filename*=UTF-8" url-codiert Weg. Nach in diesem speziellen Testfallsollte es von der MSIE9, und auf den letzten FF, Chrome, Safari; auf der unteren MSIE version soll es bieten, mit dem Namen mit dem ISO8859-1-version der Dateinamen mit Unterstrichen auf Zeichen, die nicht in dieser Codierung.

Letzte Anmerkung: die max. Größe für jedes header-Feld ist 8190 Byte auf apache. UTF-8 kann bis zu vier bytes pro Zeichen; nach rawurlencode, es ist x3 = 12 bytes pro Zeichen. Ziemlich ineffizient, aber es sollte doch theoretisch möglich, dass mehr als 600 "lächelt" %F0%9F%98%81 im Dateinamen.

InformationsquelleAutor der Antwort renergy

Klassischen ASP-Lösung

Meisten modernen Browser unterstützen die Weitergabe der Filename als UTF-8 jetzt, aber wie war der Fall mit einem Datei-Upload-Lösung, die ich verwenden, basierend auf FreeASPUpload.Net (Website existiert nicht mehr, der link verweist auf archive.org) es würde nicht funktionieren, da das Parsen der binären stützte sich auf das Lesen von Einzel-byte-ASCII-codierten Zeichenketten, die geklappt, wenn Sie übergeben UTF-8-kodierte Daten bis zu ASCII-Zeichen nicht unterstützt.

Aber ich war in der Lage, eine Lösung zu finden um den code zum Einlesen und Parsen der binären als UTF-8.

Public Function BytesToString(bytes)    'UTF-8..
  Dim bslen
  Dim i, k , N 
  Dim b , count 
  Dim str

  bslen = LenB(bytes)
  str=""

  i = 0
  Do While i < bslen
    b = AscB(MidB(bytes,i+1,1))

    If (b And &HFC) = &HFC Then
      count = 6
      N = b And &H1
    ElseIf (b And &HF8) = &HF8 Then
      count = 5
      N = b And &H3
    ElseIf (b And &HF0) = &HF0 Then
      count = 4
      N = b And &H7
    ElseIf (b And &HE0) = &HE0 Then
      count = 3
      N = b And &HF
    ElseIf (b And &HC0) = &HC0 Then
      count = 2
      N = b And &H1F
    Else
      count = 1
      str = str & Chr(b)
    End If

    If i + count - 1 > bslen Then
      str = str&"?"
      Exit Do
    End If

    If count>1 then
      For k = 1 To count - 1
        b = AscB(MidB(bytes,i+k+1,1))
        N = N * &H40 + (b And &H3F)
      Next
      str = str & ChrW(N)
    End If
    i = i + count
  Loop

  BytesToString = str
End Function

Kredit geht an Reine ASP-Datei-Upload durch die Umsetzung der BytesToString() Funktion von include_aspuploader.asp in meinem eigenen code, den ich war in der Lage zu bekommen UTF-8 Dateinamen arbeiten.

Nützliche Links

• Multipart/form-data und UTF-8 in einer ASP-Classic-Anwendung

• Unicode, UTF, ASCII -, ANSI-format Unterschiede

InformationsquelleAutor der Antwort Lankymart

Ich normalerweise URL-encode (mit %xx) in den Dateinamen, und es scheint zu funktionieren in allen Browsern. Möchten Sie vielleicht tun einige tests sowieso.

InformationsquelleAutor der Antwort Dario Solera