Content-Disposition 头字段：为 HTTP 响应中的文件提供上下文 (contents翻译中文)

Content-Disposition 头字段用于提供 HTTP 响应中的文件附加信息，例如文件名、文件类型、内联显示或附件下载等。它通过设置响应消息标头中的 HTTP 头信息来实现。

语法

Content-Disposition 头字段的语法如下：

Content-Disposition: disposition-type; disposition-paRAMs

其中：disposition-type：指定文件处理方式，例如内联显示或附件下载。disposition-params：提供附加参数，例如文件名或编码信息。

disposition-type 值

disposition-type 值指定如何处理响应中的文件。常用的值包括：inline：在浏览器中内联显示文件。attachment：指示浏览器将文件下载为附件。form-data：用于 HTML 表单提交。

disposition-params 参数

disposition-params 参数提供有关文件的附加信息，例如文件名或编码信息。常用的参数包括：filename：指定文件的建议文件名，用于附件下载。filename=：使用编码值指定文件名，以支持非 ASCII 字符。creation-Date：指定文件的创建日期和时间。modification-date：指定文件的修改日期和时间。read-date：指定文件的最后读取日期和时间。size：指定文件的大小（以字节为单位）。encoding：指定文件的编码方式，例如二进制、base64 或 gzip。

示例

以下示例显示如何使用 Content-Disposition 头字段将文件设为附件下载，并指定建议文件名：

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="myfile.txt"

以下示例显示如何使用 Content-Disposition 头字段内联显示文件：

HTTP/1.1 200OK
Content-Type: image/png
Content-Disposition: inline; filename="myimage.png"

最佳实践

以下是使用 Content-Disposition 头字段的最佳实践：明确指定 disposition-type：始终明确指定 disposition-type，以明确指示浏览器如何处理文件。使用建议文件名：为附件下载提供建议文件名，以方便用户保存文件。支持非 ASCII 字符：使用 filename 参数支持非 ASCII 字符的文件名。考虑编码：如果文件已编码，请使用 encoding 参数指定编码方式。避免滥用：仅在需要时使用 Content-Disposition 头字段。

结论

Content-Disposition 头字段是一种强大的工具，可用于为 HTTP 响应中的文件提供上下文信息。通过指定 disposition-type 和 disposition-params，可以控制文件在浏览器中的显示方式，并为用户提供有关文件的重要信息。

---

---

相关标签： 头字段、 为、 HTTP、 响应中的文件提供上下文、 Disposition、 Content、 contents翻译中文、

上一篇：利用ContentDisposition头字段优化HTTP文件

下一篇：ContentDisposition头字段在HTTP协议中的重