HTTP의 Content-Disposition 헤더에서 파일 이름 매개변수를 인코딩하는 방법은 무엇인가요?

리소스가 웹 브라우저에서 직접 렌더링되는 대신 다운로드되도록 웹 애플리케이션은 HTTP 응답의 Content-Disposition 헤더를 다음과 같은 형식으로 발행합니다:

Content-Disposition: attachment; filename=파일이름

filename 매개변수는 브라우저가 리소스를 다운로드하는 파일의 이름을 제안하는 데 사용될 수 있습니다. 그러나 RFC 2183 (Content-Disposition)은 2.3절 (The Filename Parameter)에서 파일 이름은 US-ASCII 문자만 사용할 수 있다고 명시합니다:

현재 [RFC 2045] 문법은
파라미터 값 (따라서
콘텐츠 배치 파일 이름)를
US-ASCII로 제한합니다. 우리는
파일 이름에서 임의의
문자 집합을 허용하는 것이
매우 바람직하다는 것을 인식하지만,
이 문서에서는 이를 정의하는 것이
범위를 벗어납니다.

그럼에도 불구하고 경험적 데이터에 따르면, 오늘날 가장 인기있는 웹 브라우저들은 대부분 비-US-ASCII 문자를 허용하지만 (표준이 없기 때문에) 파일 이름의 인코딩 체계와 문자 집합 명세에 대해 동의하지 않습니다. 그렇다면, 파일 이름 naïvefile (따옴표 없이 그리고 세 번째 글자가 U+00EF 인)을 콘텐츠 배치 헤더로 인코딩해야 할 때, 인기있는 브라우저들이 사용하는 다양한 체계와 인코딩은 무엇인가요?

이 질문의 목적을 위해, 인기있는 브라우저는 다음과 같습니다:

• Google Chrome


• Safari


• Internet Explorer 또는 Edge


• Firefox


• Opera

답변 1

IE7에서 어떤 문자는 작동하지만 모든 문자에 대해서는 작동하지 않습니다. 그러나 누구든지 이제는 IE7에 신경쓰지 않습니다.

이것은 안드로이드를 위해 안전한 파일 이름을 생성하는 데 사용하는 함수입니다. 다만 안드로이드에서 어떤 문자가 지원되는지는 알 수 없지만 다음에 대해 테스트해봤을 때 확실히 작동한다는 것을 알았습니다:

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: 저는 IE7과 IE8에서 테스트하였고, 작은따옴표 (')를 이스케이프하지 않아도 되었다는 것을 확인했습니다. 실패하는 예제가 있으신가요?

@Dave Van den Eynde: RFC6266에 따라 두 개의 파일 이름을 한 줄로 결합하는 것은 Android 및 IE7+8을 제외하고 작동하며, 이에 대한 코드를 업데이트했습니다. 제안해 주셔서 감사합니다.

@Thilo: GoodReader나 다른 브라우저 이외의 것에 대해서는 잘 모르겠습니다. Android 접근 방식을 사용하면 어떤 운이 좋을지도 모릅니다.

@Alex Zhukovskiy: 왜 그런 지는 모르겠지만, Connect에서 논의된대로 매우 잘 작동하지 않는 것 같습니다.

답변 2

Content-Disposition 헤더의 파일명 매개변수를 어떻게 인코딩하는지 알아보겠습니다. Content-Disposition 헤더는 HTTP 응답의 일부로, 서버가 클라이언트에게 전송하는 파일에 대한 정보를 포함합니다. 이 헤더의 filename 매개변수는 전송되는 파일의 이름을 지정하는 데 사용되며, 한국어의 경우 SEO에 맞게 인코딩을 적용해야 합니다.
SEO는 검색 엔진 최적화를 의미하며, 웹 페이지나 콘텐츠가 검색 엔진에서 노출되는 것을 높이기 위해 최적화된 기술과 전략을 적용하는 것을 말합니다. 따라서 검색 엔진에서 파일명과 관련 정보를 명확하게 이해할 수 있도록 인코딩을 적절하게 처리해야 합니다.
한국어 파일명을 인코딩하는 방법에는 여러 가지가 있지만, 가장 일반적으로 사용되는 방법은 UTF-8로 인코딩하는 것입니다. UTF-8은 대부분의 웹 브라우저와 검색 엔진에서 널리 지원되며, 다양한 언어의 문자를 효율적으로 표현할 수 있는 인코딩 방식입니다.
이를 위해, HTTP 응답의 Content-Disposition 헤더에서 filename 매개변수를 인코딩해야 합니다. 한국어를 UTF-8로 변환하려면 UTF-8로 선언된 문자열 앞에 filename*=UTF-8''을 추가해야 합니다. 이렇게 하면 한국어 문자열을 올바르게 처리하고, 검색 엔진에서 파일명을 올바르게 해석할 수 있습니다.
예를 들어, Content-Disposition 헤더에 다음과 같이 filename 매개변수를 사용하면 됩니다:
Content-Disposition: attachment; filename*=UTF-8''%ED%95%9C%EA%B5%AD%EC%96%B4%20%ED%85%8C%EC%8A%A4%ED%8A%B8.html
위의 예시에서 %ED%95%9C%EA%B5%AD%EC%96%B4%20%ED%85%8C%EC%8A%A4%ED%8A%B8는 한국어 테스트를 UTF-8로 인코딩한 것입니다. 이렇게 하면 검색 엔진에서 파일명을 정확히 인식할 수 있으며, 한국어 파일명을 포함하는 웹 페이지가 SEO에 유리해지는 효과를 기대할 수 있습니다.
이와 같이 Content-Disposition 헤더에서 파일명 매개변수를 올바르게 인코딩함으로써 한국어 파일명을 SEO에 맞게 처리할 수 있습니다. UTF-8 인코딩을 사용하는 것은 다양한 언어를 지원하며, 검색 엔진에서 파일명을 올바르게 해석하고 인식할 수 있는 좋은 방법입니다. 따라서 한국어 파일명을 처리하는 웹 애플리케이션 또는 웹 사이트에서는 이를 참고하여 파일명을 인코딩하는 작업을 수행해야 합니다.