首部字段名 | 说明 |
Cache-Control | 控制缓存的行为 |
Connection | 允许客户单和服务器指定与请求/响应链接有关的选项 |
Date | 创建报文的日期时间 |
Pragma | 报文指令 |
Trailer | 如果报文采用了分块传输编码,就可以用这个首部列出位于报文拖挂部分的首部集合 |
Transger-Encoding | 告知接受端为了保证报文的可靠传输,读报文采用了什么编码方式。 |
Upgrade | 给出了发送端可能想要“升级”使用的新版本或协议。 |
Via | 显示了报文经过的中间节点(代理、网关) |
Warning | 错误通知 |
具体的字段解释如下:
1、Cache-Control
通过指定首部字段Cache-Control的指令,就能操作缓存的工作机制。
指令的参数是可选的,多个指令之间通过“,”分隔,如:
Cache-Control: private,max-age=0,no-cache
Cache-Control的可用缓存请求指令如下:
首部字段名 | 参数 | 说明 |
no-cache | 无 | 强制向源服务器再次验证 |
no-store | 无 | 不缓存请求或相应的任何内容 |
max-age=[秒] | 必需 | 响应的最大Age值 |
max-stale(=[秒]) | 可省略 | 接受已过期的响应 |
min-fresh=[秒] | 必需 | 期望在指定时间内的响应仍有效 |
no-transform | 无 | 代理不可更改媒体类型 |
only-if-cached | 无 | 从缓存获取资源 |
cache-extension | - | 新指令标记(token) |
首部字段名 | 参数 | 说明 |
public | 无 | 可向任意方提供响应的缓存 |
private | 可省略 | 仅向特定用户返回响应 |
no-cache | 可省略 | 缓存前必需先确认其有效性 |
no-store | 无 | 不缓存请求或响应的任何内容 |
no-transform | 无 | 代理不可更改媒体类型 |
must-revalidate | 无 | 可缓存但必须再向源服务器进行确认 |
proxy-revalidate | 无 | 要求中间缓存服务器对缓存的响应有效性再进行确认 |
max-age=[] | 必需 | 响应的最大Age值 |
s-maxage=[] | 必需 | 公共缓存服务器响应的最大Age值 |
cache-extension | - | 新指令标记(token) |
1.1、public指令
当指定使用public指令时,则明确表明其他用户也可利用缓存。
格式为:
Cache-Control:public
1.2、private指令
当指定private指令后,响应只以特定的用户作为对象,这与public指令的行为相反。缓存服务器会对特定用户提供资源缓存的服务,对于其他用户发送过来的请求,代理服务器则不会返回缓存。格式为:
Cache-Control:private
1.3、no-cache指令
使用no-cache指令的目的是为了防止从缓存中返回过期的资源。客户端发送的请求中如果包含no-cache指令,则表示客户端将不会接收缓存过的响应。于是,“中间”的缓存服务器必须把客户端请求转发给源服务器。
如果服务器返回的响应中包含no-cache指令,那么缓存服务器不能对资源进行缓存。源服务器以后也将不再对缓存服务器请求中提出的资源有效性进行确认,且禁止其对响应资源进行缓存操作。
Cache-Control: no-cache=Location
由服务器返回的响应中,若报文首部字段Cache-Control中对no-cache字段名具体指定参数值,那么客户端在接收到这个被指定参数值的首部字段对应的响应报文后,就不能使用缓存。换言之,无参数值的首部字段可以使用缓存。只能在响应指令汇总指定该参数。
1.4、no-store
no-store是控制可执行缓存的对象指令。当使用no-store指令时,暗示请求或响应中包含机密信息。no-cache是不缓存过期的资源,而no-store才是真正不进行缓存。该指令规定缓存不能在本地存储请求或响应的任一部分。格式:
Cache-Control:no-store
1.5、max-age指令
当客户端发送的请求中包含max-age指令时,如果判定缓存资源的缓存时间数值比指定时间的数值更小,客户端就接受缓存的资源。灵位,当指定max-age值为0,那么缓存服务器通常需要将请求转发给源服务器。
当服务器返回响应中包含max-age指令时,缓存服务器将不对资源的有效性再作确认,而max-age数值代表资源保存为缓存的最长时间。
HTTP/1.1版本的缓存服务器同时接收到Expires和max-age,会优先处理max-age,忽略调Expires首部字段。而HTTP/1.0则相反。
格式:
Cache-Control:max-age=604800(单位:秒)
1.6、s-maxage指令
s-maxage指令的功能和max-age指令的相同,他们的不同点是s-maxage指令只适用于供多位用户使用的公共缓存服务器(如代理)。也就是所,对于向同一用户重复返回响应的服务器来说,这个额指令没有任何作用。
当使用s-maxage指令后,则直接忽略对Expires首部字段和max-age指令的处理。
格式:
Cache-Control:s-masage=604800(单位:秒)
1.7、min-fresh指令
mini-fresh指令要求缓存服务器返回至少还未过指定时间的缓存资源。
格式:
Cache-Control:min-fresh=60(单位:秒)
1.8、max-stale指令
使用max-stale可指示缓存资源,即使过期也照样接收。
如果指令未指定参数值,那么无论经过多久,客户端都会接收响应;如果指令中指定了具体数值,那么即使过期,只要仍在max-stale指定的时间内,仍旧会被客户端接收。
格式:
Cache-Control:max-stale=3600(单位:秒)
1.9、only-if-cached指令
使用only-if-cached指令表示客户端仅在缓存服务器本地缓存目标资源的情况下才会要求其返回。换言之,该指令要求缓存服务器不重新加载响应,也不会再次确认资源有效性。若发生请求缓存服务器的本地缓存无响应,则返回状态码504。
格式:
Cache-Control:only-if-cached
1.10、must-revalidate指令
使用must-revalidate指令,代理会向源服务器再次验证即将返回的响应缓存目前是否仍然有效。若代理无法连通源服务器再次获取有效资源的话,缓存必须给客户端一条504状态码。
另外,使用must-revalidate指令会忽略请求的max-stale指令。
格式:
Cache-Control:must-revalidate
1.11、proxy-revalidate指令
proxy-revalidate指令要求所有的缓存服务器在接收到客户端带有该指令的请求返回响应之前,必须再次验证缓存的有效性。
格式:
Cache-Control:proxy-revalidate
1.12、no-transform指令
使用no-transform指令规定无论是在请求还是响应中,缓存都不能改变实体主体的媒体类型。这样可以防止缓存或代理压缩图片等类似操作。
格式:
Cache-Control:no-transform
1.13、cache-extension token
通过cache-extension标记(token),可以扩展Cache-Control首部字段内的指令。例如:Cache-Control:private,community="UCI"
Cache-Control首部字段本身没有community这个指令,借助extension tokens实现了该指令的添加。如果缓存服务器不 能理解community这个新指令,就直接忽略。因此cache-extension只对理解它的缓存服务器来说有意义。
2、Connection
Connection首部字段具备两个作用:
1、控制不再转发给代理的首部字段。
格式:
Connection:不再转发的首部字段名
在客户端发送请求和服务器返回响应内,使用Connection首部字段,可控制不再转发给代理的首部字段。(即Hop-bt-hop首部)
2、管理持久连接。
Connection:close
HTTP/1.1版本的默认连接都是持久连接。为此,客户端会在持久连接上连续发送请求。当服务端想要明确断开连接时,则指定Connection首部字段的值为Close。
Connection:Keep-Alive
HTTP/1.1之前HTTP版本的默认连接都是费持久连接。为此,如果想要在旧版本的HTTP协议上维持持续连接,则需要指定 Connection首部字段的值为Keep-Alive。
3、Date
首部字段Date表明创建HTTP报文的日期和时间。
HTTP/1.1协议使用在RFC1123中规定的日期时间的格式,如下所示:
Date:Tue,03 Jul 2012 04:40:59 GMT
之前的HTTP协议使用RFC850中定义的格式:
Date:Tue,03-Jul-12 04:40:59 GMT
初次以为,还有一种与C标准库内的按时吃time()函数的输出格式一致:
Date:Tue Jul 03 04:40:59 2012
4、Pragma
Pragrma是HTTP/1.1之前的版本的历史遗留问题。仅作为与HTTP/1.0的向后兼容而定义。规范定义的形式唯一:
Pragma:no-cache
这个首部字段属于通用首部字段,但只用在客户端发送的请求中。客户端会要求所有的中间服务器不返回缓存的资源。所有的中间服务器如果都能以HTTP/1.1位基准,那就直接采用Cache-Control:no-cache指定缓存的处理方式是最为理想的。但要整体掌握全部中间服务器使用的HTTP协议版本,发送的请求要同时包含两个首部字段
Cache-Control:no-cache
Pragma:no-cache
5、Trailer
首部字段Trailer会事先说明在报文主体后记录了哪些首部字段。该首部字段可应用在HTTP/1.1版本分块传输编码时。
以上例子,指定首部字段Trailer的值为Expires,在报文主体之后出现了首部字段Expires。
6、Transfer-Encoding
首部字段Transfer-Encoding规定了传输报文主体时采用的编码方式。仅对分块传输编码有效。
7、Upgrade
首部字段Upgrade用于检测HTTP协议及其他协议是否可使用更高的版本进行通信,其参数值可以用来指定一个完全不同的通信协议。
客户端请求:
GMT /index.htm HTTP/1.1
Upgrade: TLS/1.0
Connection: Upgrade
服务器响应:
HTTP/1.1 101 Switching Protocols
Upgrade: TLS/1.0, HTTP/1.1
Connection: Upgrade
上面的例子中,首部字段Upgrade指定的值为TLS/1.0,这里的两个首部字段的对应关系,Connection的值被指定为Upgrade。
Upgrade对象仅限于客户端和邻近服务器之间,因此,使用首部字段Upgrade时,还需要额外指定Connection Upgrade
对于附有首部字段Upgrade的请求,服务器可以用101Switch Protocols状态码作为响应返回。
8、Via
使用首部字段Via是为了追踪客户端和服务器之间的请求和响应报文的传输路径。
报文经过代理或网关时,会先在首部字段Via中附加该服务器的信息,然后再进行转发。这个做法和traceroute及电子邮件的Recevied首部的工作机制类似。
首部字段Via不仅用于追踪报文的转发,还可避免请求回环的发生。所以必须在经过代理时附加该首部字段内容。
9、Warning
HTTP/1.1的Warning首部是从HTTP/1.0的响应首部(Retry-After)演变过来的。这个首部通常会告知用户一些与缓存有关的问题的警告。格式:
Warning:[警告码][警告的主机:端口号]"[警告内容]"([日期时间])
HTTP/1.1中定义了7种警告。警告码对应的警告内容仅推荐参考。另外警告码具备扩展性,后面可以追加新的警告码。
警告码 | 警告内容 | 说明 |
110 | Response is stale(响应已过期) | 代理返回已过期的资源 |
111 | Revalidation failed(再验证失败) | 代理再验证资源有效性时失效(服务器无法到底等原因) |
112 | Disconnection operation(断开连接操作) | 代理与互联网连接被故意切断 |
113 | Heuristic expiration(试探性过期) | 响应的试用期超过24小时(有效缓存的设定时间大于24小时的情况下) |
199 | Miscellaneous warning(杂项警告) | 任意的警告内容 |
214 | Transformation applied(使用了转换) | 代理对内容编码或媒体类型等执行了某些处理时 |
299 | Miscellaneous persistent warning(持久杂项警告) | 任意的警告内容 |