©
本文檔使用 php中文網手册 發布
在常规 HTTP 响应中，Content-Disposition响应标头是指示内容是否预期在浏览器中内联显示的标题，即，作为网页或作为网页的一部分或作为附件下载并且本地保存。
在一个multipart/form-data正文中，HTTP Content-Disposition通用标题是一个标题，可以在多部分主体的子部分中使用，以提供有关它适用的字段的信息。子部分由标题中定义的边界分隔Content-Type。用于身体本身，Content-Disposition没有任何作用。
所述Content-Disposition的 header 在 MIME 消息的电子邮件的更大的范围内定义的，但仅可能的参数的子集应用于 HTTP 形式和POST请求。只有值form-data，以及可选的指令name和filename，可以在 HTTP 上下文中使用。
Header type | Response header (for the main body) General header (for a subpart of a multipart body) |
|---|---|
Forbidden header name | no |
语法
作为主体的响应标题
HTTP 上下文中的第一个参数是inline（默认值，表示它可以显示在网页内，或作为网页）或attachment（表示它应该下载;大多数浏览器呈现“另存为”对话框，预先填入filename如果存在参数的值
Content-Disposition: inline Content-Disposition: attachment Content-Disposition: attachment; filename="filename.jpg"
作为多部分主体的 header
HTTP 上下文中的第一个参数总是form-data; 其他参数不区分大小写，并且有参数，在'='符号后面使用带引号的字符串语法。多个参数用分号（';'）分隔。
Content-Disposition: form-data Content-Disposition: form-data; name="fieldName"Content-Disposition: form-data; name="fieldName"; filename="filename.jpg"
指令
name后面跟着一个字符串，其中包含该字段的内容引用的 HTML 字段的名称。在同一字段中处理多个文件（例如元素的multiple属性<input type=file>）时，可能会有几个具有相同名称的子部分。
一个name有值'_charset_'表明该部分不是 HTML 区域，但默认字符集，而无需显式的字符集信息使用的部分。
filename后面是一个包含传输文件的原始名称的字符串。文件名始终是可选的，不能被应用程序盲目使用：路径信息应该被删除，并且应该转换为服务器文件系统规则。该参数提供大部分指示性信息。当与其结合使用时Content-Disposition: attachment，它被用作提供给 user.filename 的最终“另存为”对话框的默认文件名*
参数“filename”和“filename *”的区别仅在于“filename *”使用RFC 5987中定义的编码。当“文件名”和“文件名*”都出现在单个标题字段值中时，“文件名*”优于“文件名”，当两者都存在并被理解时。
例子
触发“另存为”对话框的响应：
200 OK Content-Type: text/html; charset=utf-8Content-Disposition: attachment; filename="cool.html"Content-Length: 22<HTML>Save me!</HTML>
这个简单的 HTML 文件将被保存为常规下载而不是在浏览器中显示。大多数浏览器会建议将其保存在cool.html文件名下（默认情况下）。
HTML 表单的一个示例，使用multipart/form-data使用Content-Disposition标题的格式发布：
POST /test.html HTTP/1.1Host: example.org Content-Type: multipart/form-data;boundary="boundary"--boundary Content-Disposition: form-data; name="field1"value1--boundary Content-Disposition: form-data; name="field2"; filename="example.txt"value2--boundary--
规范
Specification | Title |
|---|---|
RFC 7578 | Returning Values from Forms: multipart/form-data |
RFC 6266 | Use of the Content-Disposition Header Field in the Hypertext Transfer Protocol (HTTP) |
RFC 2183 | Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field |
浏览器兼容性
Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
兼容性说明
Content-Disposition如果提供了参数filename和filename*参数，Firefox 5 将更有效地处理 HTTP 响应头; 它会查看所有提供的名称，filename*如果有可用的名称，则使用参数，即使filename首先包含参数。以前，将使用第一个匹配参数，从而阻止使用更合适的名称。见错误588781。见还
HTML Forms
The
Content-Typedefining the boundary of the multipart body.
The
FormDatainterface used to manipulate form data for use in theXMLHttpRequestAPI.