浏览器下载中文名文件出现乱码,如何解决?

《web开发中,如何让浏览器下载文件?》 中介绍了如何让浏览器下载文件的原理,其实非常简单,本质上就是输出一个 HTTP header 头(其实是一个 MIME header 头),但对于中国开发者来说,更实际的问题是:在某些浏览器上,如果下载的文件是中文名,那很有可能出现乱码。

实际上导致这一乱现的并不是技术问题,而是标准的问题,Web 发展到如今,经历了太多的混乱,为了把乱码这个问题说清楚,我花了一天时间,寻找了一些相关资料。

先上图吧,这是我在 google 上找到的:

20-browser-rfc.png

这个图由三部分 RFC 组成,分别是 MIME、Content-Disposition HEADER、HTTP。

首先 Content-Disposition 这个头由 MIME 定义,rfc2231(MIME Parameter Value and Encoded Word Extensions:Character Sets, Languages, and Continuations)是最新的标准,描述了 MIME 中字符集及语言的标准,废弃了 rfc2184 和 rfc204。

rfc2183 基于 rfc2231 定义了在互联网上 Content-Disposition 头的标准,说明了字符集及编码,可以这样理解 rfc2183 和 rfc2231 是从不同角度建立的标准,双方并不冲突。

现在来说 HTTP,因为乱码问题是在浏览器中产生的,也就是说肯定和 HTTP 协议有关,rfc2616 是 HTTP/1.1 协议的总标准(最新标准已经分为6个了),对于 HTTP 协议来说,header 只能是 ASCII,不会遇到也没有中文的问题,但为了支持下载,它借用了 MIME 的 Content-Disposition header。

在早期,HTTP 协议建议使用 rfc2047 标准(查看上图,很早的一个 MIME 标准),但浏览器没有按照该标准执行,这个时候出现了混乱。

If a character set other than ISO-8859-1 is used, it MUST be encoded in the warn-text using the method described in RFC 2047

不同浏览器为了解决乱码问题,提出了很多不一致的解决方案,比如对 Content-Disposition 中的 filename 值进行 base64 编码或百分号编码。

这个时候可苦了程序员,为了适应不同类型的浏览器,他们需要判断 UA,针对不同 UA 输出不同的 Content-Disposition,现在我们公司很多代码也是这样的编写方式。

那么有没有好的解决方案呢,rfc5987 发布了(基于 rfc2231、rfc2183),它严格定义了在 HTTP 协议中如何标准化编码 header 头;进一步 HTTP 定义了 rfc6266,它进一步标准化了在 HTTP 中如何编码 Content-Disposition,可以认为 rfc5987 和 rfc6266 是一样的。

RFC 1806 , from which the often implemented Content-Disposition header in HTTP is derived, has a number of very serious security considerations. Content-Disposition is not part of the HTTP standard, but since it is widely implemented, we are documenting its use and risks for implementors.

那 rfc5987 如何定义编码标注的呢?建议采用 parameter*=charset'lang'value 的格式。如下:

ext-value     = charset  "'" [ language ] "'" value-chars
charset       = "UTF-8" / "ISO-8859-1" / mime-charset
language      = <Language-Tag>
value-chars   = *( pct-encoded / attr-char )
pct-encoded   = "%" HEXDIG HEXDIG
  • charset 字符集支持 ASCII 和 UTF-8
  • language 可以为空
  • 值编码,采用百分号编码
  • 当 parameter 和 parameter* 同时出现在 HTTP 头中时,浏览器应当使用后者。

对应到 Content-Disposition,就是输出下面的头:

Content-Disposition: attachment; filename="%E6%B3%95%E9%99%A2%E9%A1%B9%E7%9B%AE-%E7%B3%BB%E7%BB%9F%E6%94%AF%E6%8C%81.txt"; filename*=UTF-8''%22UTF-8%27%27%25E6%25B3%2595%25E9%2599%25A2%25E9%25A1%25B9%25E7%259B%25AE-%25E7%25B3%25BB%25E7%25BB%259F%25E6%2594%25AF%25E6%258C%2581.txt%22

新标准就是使用 filename* 代替 filename 参数,注意 UTF-8'' 后面的文件名使用百分号编码(在 PHP 中使用 rawurlencode() 函数)。为了兼容老的浏览器,同时也建议包含 filename 参数,对于这些老的浏览器来说,会忽略 filename* 这个“不标准的” field。而如果 filename 和 filename* 同时出现,较新的浏览器会忽略 filename 参数。

不过,就我的测试,在 IE 浏览器中,还是要根据 UA 输出只包含 filename field 的参数,光输出 filename* field 没用。

以下就是完整的示例:

$ua = isset($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : '';
$filename = rawurlencode($filename);

if (stripos($ua, 'msie') !== false || (stripos($ua, 'rv:11') !== false )) {
  header('Content-Disposition: attachment; filename="'.$filename.'"');
} else {
  header('Content-Disposition: attachment; filename="'.$filename.'";' . 'filename*="UTF-8\'\'' .  $filename . '"' );
} 

建议阅读:


推荐大家关注我的公众号(ID:yudadanwx,虞大胆的叽叽喳喳)和我的书《深入浅出HTTPS:从原理到实战》

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,761评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,953评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,998评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,248评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,130评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,145评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,550评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,236评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,510评论 1 291
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,601评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,376评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,247评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,613评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,911评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,191评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,532评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,739评论 2 335

推荐阅读更多精彩内容