5. 头字段定义
本节定义与缓存相关的 HTTP/1.1 头字段的语法和语义.
5.1. Age
"Age" 头字段传达发送方对自响应在源服务器生成或成功验证以来所经过时间的估计. Age 取值按第 4.2.3 节的规定计算.
Age = delta-seconds
Age 字段值是一个非负整数, 表示以秒为单位的时间 (见第 1.2.1 节).
存在 Age 头字段意味着该响应并非由源服务器为本请求生成或验证. 然而, 缺少 Age 头字段并不意味着联系过源服务器, 因为该响应可能是从某个未实现 Age 的 HTTP/1.0 缓存收到的.
5.2. Cache-Control
"Cache-Control" 头字段用于为请求/响应链上的缓存指定指令. 此类缓存指令是单向的, 即请求中存在某个指令并不意味着响应中也必须给出同一指令.
缓存 MUST 遵守本节所定义 Cache-Control 指令的要求. 关于如何处理在其他地方定义的 Cache-Control 指令, 见第 5.2.3 节.
注: 某些 HTTP/1.0 缓存可能未实现 Cache-Control.
代理无论是否实现缓存, 都 MUST 在转发的消息中透传缓存指令, 而不管这些指令对该应用是否有意义, 因为这些指令可能适用于请求/响应链上的所有接收方. 无法将某个指令定向到特定的缓存.
缓存指令由令牌 (token) 标识, 比较时大小写不敏感, 并且有一个可选参数, 该参数可以使用令牌语法和带引号字符串 (quoted-string) 语法. 对于下文所定义的、定义了参数的那些指令, 接收方应当接受两种形式, 即使其中一种被记录为更可取. 对于本规范未定义的任何指令, 接收方 MUST 接受两种形式.
Cache-Control = 1#cache-directive
cache-directive = token [ "=" ( token / quoted-string ) ]
对于下文所定义的缓存指令, 除非另有说明, 否则没有定义 (也不允许) 参数.
5.2.1. 请求 Cache-Control 指令
5.2.1.1. max-age
参数语法: delta-seconds (见第 1.2.1 节)
"max-age" 请求指令表明客户端不愿意接受年龄大于所指定秒数的响应. 除非 max-stale 请求指令同时存在, 否则客户端不愿意接受过期响应.
该指令使用参数语法的令牌形式: 例如 'max-age=5' 而非 'max-age="5"'. 发送方 SHOULD NOT 生成带引号字符串形式.
5.2.1.2. max-stale
参数语法: delta-seconds (见第 1.2.1 节)
"max-stale" 请求指令表明客户端愿意接受已超过其新鲜度生命周期的响应. 如果为 max-stale 指定了取值, 那么客户端愿意接受超过其新鲜度生命周期不超过所指定秒数的响应. 如果未为 max-stale 指定取值, 那么客户端愿意接受任意年龄的过期响应.
该指令使用参数语法的令牌形式: 例如 'max-stale=10' 而非 'max-stale="10"'. 发送方 SHOULD NOT 生成带引号字符串形式.
5.2.1.3. min-fresh
参数语法: delta-seconds (见第 1.2.1 节)
"min-fresh" 请求指令表明客户端愿意接受的响应, 其新鲜度生命周期不小于其当前年龄加上所指定的秒数. 也就是说, 客户端希望响应在至少所指定秒数内仍然保持新鲜.
该指令使用参数语法的令牌形式: 例如 'min-fresh=20' 而非 'min-fresh="20"'. 发送方 SHOULD NOT 生成带引号字符串形式.
5.2.1.4. no-cache
"no-cache" 请求指令表明, 缓存 MUST NOT 在未于源服务器上成功验证的情况下使用已存储响应来满足请求.
5.2.1.5. no-store
"no-store" 请求指令表明, 缓存 MUST NOT 存储本请求或对其所作任何响应的任何部分. 该指令同时适用于私有缓存和共享缓存. 在此语境下, "MUST NOT 存储"意味着缓存 MUST NOT 有意将该信息存储在非易失性存储中, 并且 MUST 尽最大努力在转发后尽快将该信息从易失性存储中移除.
该指令不是确保隐私的可靠或充分机制. 特别是, 恶意或已被攻陷的缓存可能不识别或不遵守该指令, 并且通信网络可能容易受到窃听.
注意, 如果包含该指令的请求由某个缓存满足, 则 no-store 请求指令不适用于已存储的响应.
5.2.1.6. no-transform
"no-transform" 请求指令表明, 中间件 (无论它是否实现缓存) MUST NOT 转换载荷, 如 [RFC7230] 第 5.7.2 节所定义.
5.2.1.7. only-if-cached
"only-if-cached" 请求指令表明客户端只希望获得已存储响应. 如果收到该指令, 缓存 SHOULD 要么使用与请求的其他约束一致的已存储响应来应答, 要么以 504 (Gateway Timeout) 状态码应答. 如果一组缓存作为内部连通性良好的统一系统运行, 则该缓存组内的某个成员缓存 MAY 在该缓存组内转发此类请求.
5.2.2. 响应 Cache-Control 指令
5.2.2.1. must-revalidate
"must-revalidate" 响应指令表明, 一旦响应已过期, 缓存 MUST NOT 在未于源服务器上成功验证的情况下使用该响应来满足后续请求.
must-revalidate 指令对于支持某些协议特性的可靠运行是必要的. 在任何情况下缓存 MUST 遵守 must-revalidate 指令; 特别是, 如果缓存因任何原因无法联系源服务器, 它 MUST 生成 504 (Gateway Timeout) 响应.
服务器应当当且仅当无法对该表示上的请求进行验证会导致不正确操作 (例如静默地未执行的金融交易) 时, 才使用 must-revalidate 指令.
5.2.2.2. no-cache
参数语法: #field-name
"no-cache" 响应指令表明, 该响应 MUST NOT 在未于源服务器上成功验证的情况下用于满足后续请求. 这允许源服务器阻止缓存在未与它联系的情况下使用该响应来满足请求, 即使对于被配置为发送过期响应的缓存也是如此.
如果 no-cache 响应指令指定了一个或多个 field-name, 那么缓存 MAY 使用该响应来满足后续请求, 但仍受制于其他缓存限制. 然而, 响应中任何具有所列 field-name 的头字段, MUST NOT 在未与源服务器成功重新验证的情况下在响应后续请求时发送. 这允许源服务器阻止响应中某些头字段的重复使用, 同时仍然允许响应其余部分被缓存.
所给出的 field-name 不限于本规范所定义的头字段集合. 字段名大小写不敏感.
该指令使用参数语法的带引号字符串形式. 发送方 SHOULD NOT 生成令牌形式 (即使对于单条目列表而言引号看起来并不需要).
注: 尽管该指令已被回移植到许多实现中, 某些 HTTP/1.0 缓存不会识别或遵守它. 此外, 带 field-name 的 no-cache 响应指令通常被缓存按收到未限定 no-cache 指令那样处理; 即, 对限定形式的特殊处理未被广泛实现.
5.2.2.3. no-store
"no-store" 响应指令表明, 缓存 MUST NOT 存储直接请求或响应的任何部分. 该指令同时适用于私有缓存和共享缓存. 在此语境下, "MUST NOT 存储"意味着缓存 MUST NOT 有意将该信息存储在非易失性存储中, 并且 MUST 尽最大努力在转发后尽快将该信息从易失性存储中移除.
该指令不是确保隐私的可靠或充分机制. 特别是, 恶意或已被攻陷的缓存可能不识别或不遵守该指令, 并且通信网络可能容易受到窃听.
5.2.2.4. no-transform
"no-transform" 响应指令表明, 中间件 (无论它是否实现缓存) MUST NOT 转换载荷, 如 [RFC7230] 第 5.7.2 节所定义.
5.2.2.5. public
"public" 响应指令表明任何缓存 MAY 存储该响应, 即使该响应通常不可缓存或只能在私有缓存中缓存. (关于在响应包含 Authorization 的请求时使用 public 的更多细节, 见第 3.2 节; 关于 public 如何影响那些由于状态码未被定义为默认可缓存而通常不会被存储的响应, 详见第 3 节; 见第 4.2.2 节.)
5.2.2.6. private
参数语法: #field-name
"private" 响应指令表明该响应消息是供单个用户使用的, 共享缓存 MUST NOT 存储它. 私有缓存 MAY 存储该响应并在此后的请求中重用它, 即使该响应通常不可缓存.
如果 private 响应指令指定了一个或多个 field-name, 则该要求仅限于与所列响应头字段相关联的字段值. 也就是说, 共享缓存 MUST NOT 存储指定的 field-name(s), 而 MAY 存储响应消息的其余部分.
所给出的 field-name 不限于本规范所定义的头字段集合. 字段名大小写不敏感.
该指令使用参数语法的带引号字符串形式. 发送方 SHOULD NOT 生成令牌形式 (即使对于单条目列表而言引号看起来并不需要).
注: 此处 "private" 一词的用法仅控制响应可以存储在何处; 它无法确保消息内容的私密性. 此外, 带 field-name 的 private 响应指令通常被缓存按收到未限定 private 指令那样处理; 即, 对限定形式的特殊处理未被广泛实现.
5.2.2.7. proxy-revalidate
"proxy-revalidate" 响应指令与 must-revalidate 响应指令含义相同, 只是它不适用于私有缓存.
5.2.2.8. max-age
参数语法: delta-seconds (见第 1.2.1 节)
"max-age" 响应指令表明, 该响应在其年龄大于所指定秒数之后应被视为过期.
该指令使用参数语法的令牌形式: 例如 'max-age=5' 而非 'max-age="5"'. 发送方 SHOULD NOT 生成带引号字符串形式.
5.2.2.9. s-maxage
参数语法: delta-seconds (见第 1.2.1 节)
"s-maxage" 响应指令表明, 在共享缓存中, 该指令所指定的最大年龄覆盖 max-age 指令或 Expires 头字段所指定的最大年龄. s-maxage 指令还隐含 proxy-revalidate 响应指令的语义.
该指令使用参数语法的令牌形式: 例如 's-maxage=10' 而非 's-maxage="10"'. 发送方 SHOULD NOT 生成带引号字符串形式.
5.2.3. 缓存控制扩展
Cache-Control 头字段可以通过使用一个或多个缓存扩展 (cache-extension) 令牌来扩展, 每个令牌带有一个可选取值. 缓存 MUST 忽略无法识别的缓存指令.
信息性扩展 (即不要求改变缓存行为的扩展) 可以在不改变其他指令语义的情况下添加.
行为性扩展 (behavioral extension) 的设计方式是对现有缓存指令基础起修饰作用. 新指令和旧指令同时给出, 这样不理解新指令的应用将默认采用旧指令所指定的行为, 而理解新指令的应用会将其识别为修改与旧指令相关的要求. 通过这种方式, 可以在不破坏已部署缓存的情况下扩展现有缓存控制指令.
例如, 考虑一个假设的新响应指令 "community", 它作为 private 指令的修饰符: 除了私有缓存之外, 任何仅由该具名 community 的成员共享的缓存也被允许缓存该响应. 如果源服务器希望允许 UCI 社区在它们的共享缓存中使用本来私有的响应, 可以通过包含以下内容来实现:
Cache-Control: private, community="UCI"
识别该 community 缓存扩展的缓存可以按照该扩展来放宽其行为. 不识别该 community 缓存扩展的缓存会忽略它并遵守 private 指令.
5.3. Expires
"Expires" 头字段给出响应被视为过期的日期/时间. 关于新鲜度模型的进一步讨论, 见第 4.2 节.
存在 Expires 字段并不意味着原始资源将在该时间点、之前或之后发生变化或不再存在.
Expires 取值是一个 HTTP-date 时间戳, 如 [RFC7231] 第 7.1.1.1 节所定义.
Expires = HTTP-date
例如
Expires: Thu, 01 Dec 1994 16:00:00 GMT
缓存接收方 MUST 将无效的日期格式 (尤其是取值 "0") 解释为表示过去的时间 (即"已经过期").
如果响应包含带有 max-age 指令的 Cache-Control 字段 (第 5.2.2.8 节), 则接收方 MUST 忽略 Expires 字段. 同样, 如果响应包含 s-maxage 指令 (第 5.2.2.9 节), 则共享缓存接收方 MUST 忽略 Expires 字段. 在这两种情况下, Expires 中的取值仅供那些尚未实现 Cache-Control 字段的接收方使用.
没有时钟的源服务器 MUST NOT 生成 Expires 字段, 除非其取值表示一个固定的过去时间 (始终已过期), 或者其取值已由具有可靠时钟的系统或用户与该资源相关联.
历史上, HTTP 要求 Expires 字段值不超过一年之后. 虽然更长的新鲜度生命周期不再被禁止, 但极大的取值已被证明会造成问题 (例如由于使用 32 位整数表示时间值而导致的时钟溢出), 并且许多缓存的淘汰时间会远早于此.
5.4. Pragma
"Pragma" 头字段提供与 HTTP/1.0 缓存的向后兼容性, 使客户端能够指定它们能够理解的 "no-cache" 请求 (因为 Cache-Control 直到 HTTP/1.1 才被定义). 当请求中同时存在并理解 Cache-Control 头字段时, Pragma 被忽略.
在 HTTP/1.0 中, Pragma 被定义为供接收方使用的、由实现指定的指令的可扩展字段. 本规范弃用此类扩展以提高互操作性.
Pragma = 1#pragma-directive
pragma-directive = "no-cache" / extension-pragma
extension-pragma = token [ "=" ( token / quoted-string ) ]
当请求中不存在 Cache-Control 头字段时, 缓存 MUST 将 no-cache 请求 pragma-directive 视为与存在 "Cache-Control: no-cache" 具有相同效果 (见第 5.2.1 节).
在发送 no-cache 请求时, 客户端应当同时包含 pragma 和 cache-control 指令, 除非有意省略 Cache-Control: no-cache 以便把其他 Cache-Control 响应指令定向到 HTTP/1.1 缓存. 例如:
GET / HTTP/1.1
Host: www.example.com
Cache-Control: max-age=30
Pragma: no-cache
将约束 HTTP/1.1 缓存提供的响应不超过 30 秒, 同时阻止不理解 Cache-Control 的实现提供缓存响应.
注: 由于 "Pragma: no-cache" 在响应中的含义未被规定, 它在响应中不能可靠地替代 "Cache-Control: no-cache".
5.5. Warning
"Warning" 头字段用于携带关于消息状态或转换的、可能未反映在状态码中的附加信息. 这类信息通常用于警示由缓存操作或对消息载荷施加的转换可能引入的不正确性.
警告可以用于其他目的, 既包括与缓存相关的, 也包括其他方面. 使用警告而不是错误状态码, 可将这些响应与真正的失败区分开来.
Warning 头字段一般可以应用于任何消息, 不过某些 warn-code 是缓存特有的, 只能应用于响应消息.
Warning = 1#warning-value
warning-value = warn-code SP warn-agent SP warn-text
[ SP warn-date ]
warn-code = 3DIGIT
warn-agent = ( uri-host [ ":" port ] ) / pseudonym
; the name or pseudonym of the server adding
; the Warning header field, for use in debugging
; a single "-" is recommended when agent unknown
warn-text = quoted-string
warn-date = DQUOTE HTTP-date DQUOTE
一个响应中可以生成多个警告 (由源服务器或缓存生成), 包括多个 warn-code 编号相同而仅 warn-text 不同的警告.
收到一个或多个 Warning 头字段的用户代理 SHOULD 按它们在响应中出现的顺序, 尽可能多地将它们告知用户. 鼓励生成多个 Warning 头字段的发送方在排序时考虑到这种用户代理行为. 生成新的 Warning 头字段的发送方 MUST 将它们追加在任何现有 Warning 头字段之后.
警告被赋予三位数字的 warn-code. 第一位数字指示该 Warning 在验证之后是否必须从已存储响应中删除:
-
1xx warn-code 描述响应的新鲜度或验证状态, 因此它们 MUST 在验证后被缓存删除. 它们只能由缓存在验证缓存条目时生成, 并且在任何其他情况下 MUST NOT 生成.
-
2xx warn-code 描述表示的某些方面, 这些方面不会因验证而被纠正 (例如表示的有损压缩), 并且它们 MUST NOT 在验证后被缓存删除, 除非发送了完整响应, 此时则 MUST 删除.
如果发送方在要发送给已知仅实现 HTTP/1.0 的接收方的消息中生成一个或多个 1xx warn-code, 则发送方 MUST 在每个相应的 warning-value 中包含一个与消息中 Date 头字段匹配的 warn-date. 例如:
HTTP/1.1 200 OK
Date: Sat, 25 Aug 2012 23:34:45 GMT
Warning: 112 - "network down" "Sat, 25 Aug 2012 23:34:45 GMT"
警告带有描述错误的 warn-text, 例如用于日志记录. 它仅供参考, 其内容不影响对 warn-code 的解释.
如果使用、评估或显示 Warning 头字段的接收方收到的 warn-date 与同一消息中的 Date 取值不同, 则接收方 MUST 在存储、转发或使用该消息之前排除包含该 warn-date 的 warning-value. 这使接收方能够排除在缓存验证后被不适当地保留下来的 warning-value. 如果所有 warning-value 都被排除, 则接收方 MUST 同时排除该 Warning 头字段.
本规范定义了以下 warn-code, 每个都带有推荐的英文 warn-text 及其含义说明. 定义附加 warn-code 的流程见第 7.2.1 节.
5.5.1. Warning: 110 - "Response is Stale"
缓存 SHOULD 在发送的响应过期时生成此警告.
5.5.2. Warning: 111 - "Revalidation Failed"
当缓存由于无法到达服务器而导致尝试验证响应失败、因而发送过期响应时, 缓存 SHOULD 生成此警告.
5.5.3. Warning: 112 - "Disconnected Operation"
如果缓存有意与网络其余部分断开一段时间, 缓存 SHOULD 生成此警告.
5.5.4. Warning: 113 - "Heuristic Expiration"
如果缓存以启发式方式选择了大于 24 小时的新鲜度生命周期, 且响应的年龄大于 24 小时, 则缓存 SHOULD 生成此警告.
5.5.5. Warning: 199 - "Miscellaneous Warning"
警告文本可以包含任意信息, 以便呈现给人类用户或记录到日志. 收到此警告的系统 MUST NOT 采取任何自动化操作, 除了向用户呈现该警告.
5.5.6. Warning: 214 - "Transformation Applied"
如果代理对表示施加了任何转换 (例如更改内容编码 (content-coding)、媒体类型 (media-type), 或者修改表示数据), 除非该 Warning 码已出现在响应中, 则该 Warning 码 MUST 由代理添加.
5.5.7. Warning: 299 - "Miscellaneous Persistent Warning"
警告文本可以包含任意信息, 以便呈现给人类用户或记录到日志. 收到此警告的系统 MUST NOT 采取任何自动化操作.