Header Fields

HTTP标头字段提供有关请求或响应或有关在邮件正文中发送的对象的必需信息。 有四种类型的HTTP消息头:

• General-header:这些头字段对请求和响应消息都具有普遍适用性。

• Client Request-header:这些标头字段仅适用于请求消息。

• Server Response-header:这些头字段仅适用于响应消息。

• Entity-header:这些标头字段定义关于实体主体的元信息，或者，如果不存在主体，则定义关于请求标识的资源的元信息。

一般标题

Cache-Control

Cache-Control通用头字段用于指定所有缓存系统必须遵守的指令。 语法如下:

Cache-Control : cache-request-directive|cache-response-directive

HTTP客户端或服务器可以使用Cache-control通用头来指定缓存的参数或从缓存中请求某些类型的文档。 缓存指令在逗号分隔列表中指定。 例如:

Cache-control: no-cache

下表列出了客户端在其HTTP请求中可以使用的重要缓存请求指令:

服务器在其HTTP响应中可以使用以下重要的缓存响应指令:

连接(Connection)

Connection general-header字段允许发送方指定该特定连接所需的选项，并且不能由代理通过其他连接进行通信。 以下是使用连接头的简单语法:

Connection : "Connection"

HTTP/1.1定义了“关闭”连接选项，发送方在完成响应后发出连接将被关闭的信号。 例如:

Connection: close

默认情况下，HTTP 1.1使用持久连接，其中连接在事务后不会自动关闭。 另一方面，HTTP 1.0默认情况下没有持久连接。 如果1.0客户端希望使用持久连接，则它使用keep-alive参数，如下所示:

Connection: keep-alive

Date

所有HTTP日期/时间戳必须以格林威治标准时间（GMT）表示，无一例外。 允许HTTP应用程序使用以下三种日期/时间戳表示中的任何一种:

Sun, 06 Nov 1994 08:49:37 GMT  ; RFC 822, updated by RFC 1123
Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
Sun Nov  6 08:49:37 1994       ; ANSI C's asctime() format

这里第一种格式是最优选的格式。

Pragma

Pragma general-header字段用于包括可能适用于请求/响应链中任何收件人的特定于实现的指令。 例如:

Pragma: no-cache

HTTP/1.0中定义的唯一指令是no-cache指令，并在HTTP 1.1中维护以实现向后兼容。 将来不会定义新的Pragma指令。

Trailer

预告片通用字段值指示给定的标题字段集存在于使用分块传输编码编码的消息的尾部中。 以下是Trailer标题字段的语法:

Trailer : field-name

“预告片”标题字段中列出的邮件标题字段不得包含以下标题字段:

• Transfer-Encoding

• Content-Length

• Trailer

Transfer-Encoding

Transfer-Encoding通用标头字段指示已对邮件正文应用了哪种类型的转换，以便在发件人和收件人之间安全地进行转换。 这与内容编码不同，因为传输编码是消息的属性，而不是实体主体的属性。 Transfer-Encoding标头字段的语法如下:

Transfer-Encoding: chunked

所有传输编码值都不区分大小写。

Upgrade

Upgrade通用标头允许客户端指定它支持的其他通信协议，并且如果服务器发现它适合切换协议，则希望使用它们。 例如:

Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11

Upgrade头字段旨在提供一种从HTTP/1.1转换到其他不兼容协议的简单机制。

Via

网关和代理必须使用Via通用标头来指示中间协议和接收方。 例如，请求消息可以从HTTP/1.0用户代理发送到代号为“fred”的内部代理，该代理使用HTTP/1.1将请求转发到nowhere.com上的公共代理，该代理完成请求将其转发到www.ics.uci.edu的原始服务器。 www.ics.uci.edu收到的请求将具有以下Via头字段:

Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)

Upgrade头字段旨在提供一种从HTTP/1.1转换到其他不兼容协议的简单机制。

Warning

Warning general-header用于携带有关消息状态或转换的其他信息，这些信息可能不会反映在消息中。 响应可能带有多个警告标头。

Warning : warn-code SP warn-agent SP warn-text SP warn-date

客户请求标头

Accept

Accept request-header字段可用于指定响应可接受的某些媒体类型。 一般语法如下:

Accept: type/subtype [q=qvalue]

可以用逗号分隔多种媒体类型，可选的qvalue代表0到1范围内接受类型的可接受质量级别。以下是一个示例:

Accept: text/plain; q=0.5, text/html, text/x-dvi; q=0.8, text/x-c

这将被解释为text/html和text/xc并且是首选媒体类型，但如果它们不存在，则发送text/x-dvi实体，如果不存在，则发送text/plain实体。

Accept-Charset

Accept-Charset请求标头字段可用于指示响应可接受的字符集。 以下是一般语法:

Accept-Charset: character_set [q=qvalue]

可以用逗号分隔多个字符集，可选的qvalue表示非优先字符集的可接受质量级别，范围为0到1.以下是一个示例:

Accept-Charset: iso-8859-5, unicode-1-1; q=0.8

特殊值“*”（如果存在于Accept-Charset字段中）与每个字符集匹配，如果不存在Accept-Charset标头，则默认值为任何字符集都可接受。

Accept-Encoding

Accept-Encoding请求标头字段类似于Accept，但限制响应中可接受的内容编码。 一般语法是:

Accept-Encoding: encoding types

示例如下:

Accept-Encoding: compress, gzip
Accept-Encoding:
Accept-Encoding: *
Accept-Encoding: compress;q=0.5, gzip;q=1.0
Accept-Encoding: gzip;q=1.0, identity; q=0.5, *;q=0

Accept-Language

Accept-Language请求标头字段类似于Accept，但限制首选的自然语言集作为对请求的响应。 一般语法是:

Accept-Language: language [q=qvalue]

可以用逗号分隔多种语言，可选的qvalue表示非优选语言的可接受质量级别，范围为0到1.以下是一个示例:

Accept-Language: da, en-gb;q=0.8, en;q=0.7

授权 (Authorization)

Authorization请求标头字段值由包含所请求资源领域的用户代理的认证信息的凭证组成。 一般语法是:

Authorization : credentials

HTTP/1.0规范定义了BASIC授权方案，其中授权参数是username:password以base 64编码的字符串。以下是一个示例:

Authorization: BASIC Z3Vlc3Q6Z3Vlc3QxMjM=

值guest:guest123为guest:guest123 ，其中guest是用户ID， guest123是密码。

Cookie

Cookie请求标头字段值包含为该URL存储的名称/值对信息。 以下是一般语法:

Cookie: name=value

可以使用分号指定多个cookie，如下所示:

Cookie: name1=value1;name2=value2;name3=value3

Expect

Expect request-header字段用于指示客户端需要一组特定的服务器行为。 一般语法是:

Expect : 100-continue | expectation-extension

如果服务器收到包含Expect字段的请求，该字段包含它不支持的期望扩展，则它必须以417（期望失败）状态响应。

从

From request-header字段包含控制请求用户代理的人类用户的Internet电子邮件地址。 以下是一个简单的例子:

From: webmaster@w3.org

该头字段可用于记录目的，并用作识别无效或不需要的请求源的手段。

Host

Host request-header字段用于指定Internet主机和所请求资源的端口号。 一般语法是:

Host : "Host" ":" host [ ":" port ] ;

没有任何尾随端口信息的host意味着默认端口，即80.例如，原始服务器上http://www.w3.org/pub/WWW/的请求将是:

GET /pub/WWW/ HTTP/1.1
Host: www.w3.org

If-Match

If-Match请求标头字段与方法一起使用以使其成为条件。 仅当此标记中的给定值与ETag表示的给定实体标记匹配时，此标头才会请求服务器执行所请求的方法。 一般语法是:

If-Match : entity-tag

星号（*）匹配任何实体，仅当实体存在时，事务才会继续。 以下是可能的例子:

If-Match: "xyzzy"
If-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
If-Match: *

如果没有实体标签匹配，或者如果给出“*”并且不存在当前实体，则服务器不能执行所请求的方法，并且必须返回412（Precondition Failed）响应。

If-Modified-Since

If-Modified-Since请求标头字段与方法一起使用以使其成为条件。 如果自该字段中指定的时间以来未请求修改请求的URL，则不会从服务器返回实体; 相反，将返回304（未修改）响应，而不返回任何消息体。 if-modified-since的一般语法是:

If-Modified-Since : HTTP-date

该领域的一个例子是:

If-Modified-Since: Sat, 29 Oct 1994 19:43:31 GMT

如果没有实体标签匹配，或者如果给出“*”并且不存在当前实体，则服务器不能执行所请求的方法，并且必须返回412（Precondition Failed）响应。

If-None-Match

If-None-Match请求标头字段与方法一起使用以使其成为条件。 仅当此标记中的给定值之一与ETag表示的给定实体标记匹配时，此标头才会请求服务器执行所请求的方法。 一般语法是:

If-None-Match : entity-tag

星号（*）匹配任何实体，仅当实体不存在时，事务才会继续。 以下是可能的示例:

If-None-Match: "xyzzy"
If-None-Match: "xyzzy", "r2d2xxxx", "c3piozzzz"
If-None-Match: *

If-Range

If-Range请求标头字段可以与条件GET一起使用，以仅请求缺少的实体部分（如果尚未更改），以及整个实体（如果已更改）。 一般语法如下:

If-Range : entity-tag | HTTP-date

可以使用实体标签或日期来标识已经接收的部分实体。 例如:

If-Range: Sat, 29 Oct 1994 19:43:31 GMT

这里，如果文档自给定日期以来未被修改，则服务器返回Range标头给出的字节范围，否则返回所有新文档。

If-Unmodified-Since

If-Unmodified-Since请求标头字段与方法一起使用以使其成为条件。 一般语法是:

If-Unmodified-Since : HTTP-date

如果自该字段中指定的时间以来未请求修改所请求的资源，则服务器应执行所请求的操作，就像If-Unmodified-Since标头不存在一样。 例如:

If-Unmodified-Since: Sat, 29 Oct 1994 19:43:31 GMT

如果请求导致除2xx或412状态之外的任何内容，则应忽略If-Unmodified-Since标头。

Max-Forwards

Max-Forwards请求标头字段提供了一种TRACE和OPTIONS方法的机制，用于限制可以将请求转发到下一个入站服务器的代理或网关的数量。 这是一般语法:

Max-Forwards : n

Max-Forwards值是十进制整数，表示可以转发此请求消息的剩余次数。 这对于使用TRACE方法进行调试非常有用，可以避免无限循环。 例如:

Max-Forwards : 5

对于HTTP规范中定义的所有其他方法，可以忽略Max-Forwards头字段。

Proxy-Authorization

Proxy-Authorization请求标头字段允许客户端将自己（或其用户）标识到需要认证的代理。 这是一般语法:

Proxy-Authorization : credentials

Proxy-Authorization字段值包含包含代理的用户代理的身份验证信息和/或所请求资源的域的凭证。

范围 (Range)

Range request-header字段指定从文档请求的内容的部分范围。 一般语法是:

Range: bytes-unit=first-byte-pos "-" [last-byte-pos]

byte-range-spec中的first-byte-pos值给出了一个范围内第一个字节的字节偏移量。 last-byte-pos值给出范围中最后一个字节的字节偏移量; 也就是说，指定的字节位置是包含的。 您可以将字节单位指定为字节。 字节偏移从零开始。 一些简单的例子如下:

- The first 500 bytes 
Range: bytes=0-499
- The second 500 bytes
Range: bytes=500-999
- The final 500 bytes
Range: bytes=-500
- The first and last bytes only
Range: bytes=0-0,-1

可以列出多个范围，以逗号分隔。 如果缺少以逗号分隔的字节范围中的第一个数字，则假定该范围从文档末尾开始计数。 如果缺少第二个数字，则范围是文档末尾的字节n。

Referer

Referer request-header字段允许客户端指定从中请求URL的资源的地址（URI）。 一般语法如下:

Referer : absoluteURI | relativeURI

以下是一个简单的例子:

Referer: http://www.xnip.org/http/index.htm

如果字段值是相对URI，则应相对于Request-URI进行解释。

TE

TE请求头字段指示它愿意在响应中接受什么扩展transfer-coding以及它是否愿意接受分块transfer-coding尾部字段。 以下是一般语法:

TE   : t-codings

关键字“预告片”的存在表示客户端愿意接受分块传输编码中的预告片字段，并指定其中一种方式:

TE: deflate
TE:
TE: trailers, deflate;q=0.5

如果TE字段值为空或者如果不存在TE字段，则仅对传输编码进行chunked 。 没有传输编码的消息总是可以接受的。

User-Agent

User-Agent请求标头字段包含有关发起请求的用户代理的信息。 以下是一般语法:

User-Agent : product | comment

例:

User-Agent: Mozilla/4.0 (compatible; MSIE5.01; Windows NT)

服务器响应标头

Accept-Ranges

Accept-Ranges响应头字段允许服务器指示其接受资源的范围请求。 一般语法是:

Accept-Ranges  : range-unit | none

例如，接受字节范围请求的服务器可以发送:

Accept-Ranges: bytes

不接受任何资源范围请求的服务器可能会发送:

Accept-Ranges: none

这将建议客户不要尝试范围请求。

Age

Age response-header字段传达发送方对自原始服务器生成响应（或其重新验证）以来的时间量的估计。 一般语法是:

Age : delta-seconds

年龄值是非负十进制整数，表示以秒为单位的时间。 以下是一个简单的例子:

Age: 1030

包含缓存的HTTP/1.1服务器必须在从其自己的缓存生成的每个响应中包含Age头字段。

ETag

ETag响应头字段提供所请求变体的实体标签的当前值。 一般语法是:

ETag :  entity-tag

以下是一些简单的例子:

ETag: "xyzzy"
ETag: W/"xyzzy"
ETag: ""

Location

Location response-header字段用于将收件人重定向到Request-URI以外的位置以完成。 一般语法是:

Location : absoluteURI

以下是一个简单的例子:

Location: http://www.xnip.org/http/index.htm

Content-Location头字段与Location的不同之处在于Content-Location标识请求中包含的实体的原始位置。

Proxy-Authenticate

Proxy-Authenticate响应头字段必须作为407（需要代理身份验证）响应的一部分包含在内。 一般语法是:

Proxy-Authenticate  : challenge

Retry-After

Retry-After响应头字段可以与503（服务不可用）响应一起使用，以指示服务预期对请求客户端不可用的时间。 一般语法是:

Retry-After : HTTP-date | delta-seconds

例子:

Retry-After: Fri, 31 Dec 1999 23:59:59 GMT
Retry-After: 120

在后一个例子中，延迟是2分钟。

服务器

Server response-header字段包含有关源服务器用于处理请求的软件的信息。 一般语法是:

Server : product | comment

以下是一个简单的例子:

Server: Apache/2.2.14 (Win32)

如果通过代理转发响应，则代理应用程序不得修改Server响应标头。

Set-Cookie

Set-Cookie响应头字段包含要为此URL保留的名称/值对信息。 一般语法是:

Set-Cookie: NAME=VALUE; OPTIONS

Set-Cookie响应头包括令牌Set-Cookie，后面是一个或多个cookie的逗号分隔列表。 以下是您可以指定为选项的可能值:

以下是服务器生成的简单cookie标头的示例:

Set-Cookie: name1=value1,name2=value2; Expires=Wed, 09 Jun 2021 10:18:14 GMT

Vary

Vary响应头字段指定实体具有多个源，因此可以根据指定的请求头列表而变化。 以下是一般语法:

Vary : field-name

您可以指定由逗号分隔的多个标头，并且星号“*”的值表示未指定的参数不限于请求标头。 以下是一个简单的例子:

Vary: Accept-Language, Accept-Encoding

这里的字段名称不区分大小写。

WWW-Authenticate

WWW-Authenticate响应头字段必须包含在401（未授权）响应消息中。 字段值包括至少一个挑战，该挑战指示适用于Request-URI的认证方案和参数。 一般语法是:

WWW-Authenticate : challenge

WWW- Authenticate字段值可能包含多个质询，或者如果提供了多个WWW-Authenticate头字段，则质询本身的内容可以包含以逗号分隔的身份验证参数列表。 以下是一个简单的例子:

WWW-Authenticate: BASIC realm="Admin"

实体标题

Allow

Allow entity-header字段列出Request-URI标识的资源支持的方法集。 一般语法是:

Allow : Method

您可以指定以逗号分隔的多个方法。 以下是一个简单的例子:

Allow: GET, HEAD, PUT

此字段无法阻止客户端尝试其他方法。

Content-Encoding

Content-Encoding实体标题字段用作媒体类型的修饰符。 一般语法是:

Content-Encoding : content-coding

内容编码是Request-URI标识的实体的特征。 以下是一个简单的例子:

Content-Encoding: gzip

如果请求消息中的实体的内容编码对于源服务器是不可接受的，则服务器应该以状态代码415（不支持的媒体类型）进行响应。

Content-Language

Content-Language entity-header字段描述了所包含实体的目标受众的自然语言。 以下是一般语法:

Content-Language : language-tag

可以针对针对多个受众的内容列出多种语言。 以下是一个简单的例子:

Content-Language: mi, en

内容语言的主要目的是允许用户根据用户自己的首选语言识别和区分实体。

Content-Length

Content-Length实体头字段指示实体主体的大小，以十进制数量的OCTET发送给接收者，或者在HEAD方法的情况下，指示将被发送的实体主体的大小，请求是GET。 一般语法是:

Content-Length : DIGITS

以下是一个简单的例子:

Content-Length: 3495

任何大于或等于零的Content-Length都是有效值。

Content-Location

当该实体可从与所请求资源的URI分开的位置访问时， Content-Location实体头字段可用于提供消息中包含的实体的资源位置。 一般语法是:

Content-Location:  absoluteURI | relativeURI 

以下是一个简单的例子:

Content-Location: http://www.xnip.org/http/index.htm

Content-Location的值还定义了实体的基URI。

Content-MD5

Content-MD5实体标题字段可用于提供实体的MD5摘要，用于在接收时检查消息的完整性。 一般语法是:

Content-MD5  : md5-digest using base64 of 128 bit MD5 digest as per RFC 1864

以下是一个简单的例子:

Content-MD5  : 8c2d46911f3f5a326455f0ed7a8ed3b3

MD5摘要是基于实体主体的内容计算的，包括已应用的任何内容编码，但不包括应用于消息主体的任何传输编码。

Content-Range

Content-Range实体标题字段与部分实体主体一起发送，以指定应在整个实体主体中应用部分主体的位置。 一般语法是:

Content-Range : bytes-unit SP first-byte-pos "-" last-byte-pos

假设实体包含总共1234个字节的byte-content-range-spec值的示例:

- The first 500 bytes:
Content-Range : bytes 0-499/1234
- The second 500 bytes:
Content-Range : bytes 500-999/1234
- All except for the first 500 bytes:
Content-Range : bytes 500-1233/1234
- The last 500 bytes:
Content-Range : bytes 734-1233/1234

当HTTP消息包括单个范围的内容时，该内容与Content-Range标头一起传输，Content-Length标头显示实际传输的字节数。 例如，

HTTP/1.1 206 Partial content
Date: Wed, 15 Nov 1995 06:25:24 GMT
Last-Modified: Wed, 15 Nov 1995 04:58:08 GMT
Content-Range: bytes 21010-47021/47022
Content-Length: 26012
Content-Type: image/gif

Content-Type

Content-Type entity-header字段指示发送给接收者的实体主体的媒体类型，或者在HEAD方法的情况下，指示已经发送的媒体类型，如果请求是GET。 一般语法是:

Content-Type : media-type

以下是一个例子:

Content-Type: text/html; charset=ISO-8859-4

Expires

Expires entity-header字段给出了响应被认为是陈旧的日期/时间。 一般语法是:

Expires : HTTP-date

以下是一个例子:

Expires: Thu, 01 Dec 1994 16:00:00 GMT

Last-Modified

Last-Modified实体标题字段指示源服务器认为变体上次修改的日期和时间。 一般语法是:

Last-Modified: HTTP-date

以下是一个例子:

Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT