Apache 模块 mod_cache

CacheDefaultExpire 指令

CacheDefaultExpire 指令指定一个默认时间（以秒为单位），用于缓存文档，前提是文档未提供过期日期或最后修改日期。使用 CacheMaxExpire 指令指定的 value 不会覆盖此设置。

CacheDefaultExpire 86400

CacheDetailHeader 指令

当 CacheDetailHeader 指令打开时，将在响应中添加一个 **X-Cache-Detail** 标头，其中包含特定缓存决策的详细原因。

在开发缓存的 RESTful 服务期间，将有关缓存决策的附加信息写入响应标头可能很有用，以确认服务和客户端是否已正确使用 Cache-Control 和其他标头。

如果使用正常处理程序，此指令可能会出现在 <Directory> 或 <Location> 指令中。如果使用快速处理程序，此指令必须出现在服务器或虚拟主机上下文中，否则设置将被忽略。

# Enable the X-Cache-Detail header
CacheDetailHeader on

CacheDisable 指令

CacheDisable 指令指示 mod_cache *不要* 缓存 url-string 及其以下的 URL。

CacheDisable "/local_files"

如果在 <Location> 指令中使用，则需要在 Location 以下指定路径，或者如果使用“on”一词，则将禁用整个位置的缓存。

<Location "/foo">
    CacheDisable on
</Location>

在 2.2.12 及更高版本中，可以使用 no-cache 环境变量来禁用更细粒度的资源集的缓存。

另请参阅

• Apache 中的环境变量

CacheEnable 指令

CacheEnable 指令指示 mod_cache 缓存 url-string 及其以下的 URL。缓存存储管理器使用 cache_type 参数指定。 CacheEnable 指令也可以放在 <Location> 或 <LocationMatch> 部分中，以指示内容是可缓存的。 cache_type disk 指示 mod_cache 使用由 mod_cache_disk 实现的基于磁盘的存储管理器。 cache_type socache 指示 mod_cache 使用由 mod_cache_socache 实现的基于共享对象缓存的存储管理器。

如果不同的 CacheEnable 指令之间的 URL 空间重叠（如以下示例所示），则将运行每个可能的存储管理器，直到第一个实际处理请求的存储管理器为止。存储管理器运行的顺序由配置文件中 CacheEnable 指令的顺序决定。 CacheEnable 指令在 <Location> 或 <LocationMatch> 部分中处理，优先于全局定义的 CacheEnable 指令。

在充当转发代理服务器时，url-string 必须至少以应启用缓存的协议开头。

# Cache content (normal handler only)
CacheQuickHandler off
<Location "/foo">
    CacheEnable disk
</Location>

# Cache regex (normal handler only)
CacheQuickHandler off
<LocationMatch "foo$">
    CacheEnable disk
</LocationMatch>

# Cache all but forward proxy url's (normal or quick handler)
CacheEnable  disk  /

# Cache FTP-proxied url's (normal or quick handler)
CacheEnable  disk  ftp://

# Cache forward proxy content from www.example.org (normal or quick handler)
CacheEnable  disk  http://www.example.org/

以 **"*"** 开头的主机名匹配所有以该后缀结尾的主机名。以 **"."** 开头的主机名匹配包含以下域名组件的所有主机名。

# Match www.example.org, and fooexample.org
CacheEnable  disk  "http://*example.org/"
# Match www.example.org, but not fooexample.org
CacheEnable  disk  "http://.example.org/"

在 2.2.12 及更高版本中，可以使用 no-cache 环境变量来禁用更细粒度的资源集的缓存。

另请参阅

• Apache 中的环境变量

CacheHeader 指令

当 CacheHeader 指令打开时，将在响应中添加一个 **X-Cache** 标头，其中包含此响应的缓存状态。如果使用正常处理程序，此指令可能会出现在 <Directory> 或 <Location> 指令中。如果使用快速处理程序，此指令必须出现在服务器或虚拟主机上下文中，否则设置将被忽略。

HIT

实体是新鲜的，并且是从缓存中提供的。

REVALIDATE

实体已过期，已成功重新验证，并已从缓存中提供。

MISS

实体是从上游服务器获取的，并且未从缓存中提供。

# Enable the X-Cache header
CacheHeader on

X-Cache: HIT from localhost

CacheIgnoreCacheControl 指令

通常，包含 Cache-Control: no-cache 或 Pragma: no-cache 标头值的请求不会从缓存中提供。 CacheIgnoreCacheControl 指令允许覆盖此行为。 CacheIgnoreCacheControl On 告诉服务器尝试从缓存中提供资源，即使请求包含 no-cache 标头值。需要授权的资源 *永远不会* 被缓存。

CacheIgnoreCacheControl On

另请参阅

• CacheStorePrivate
• CacheStoreNoStore

CacheIgnoreHeaders 指令

根据 RFC 2616，逐跳 HTTP 头部不会存储在缓存中。以下 HTTP 头部是逐跳头部，因此无论 CacheIgnoreHeaders 的设置如何，都不会存储在缓存中。

• Connection
• Keep-Alive
• Proxy-Authenticate
• Proxy-Authorization
• TE
• Trailers
• Transfer-Encoding
• Upgrade

CacheIgnoreHeaders 指定了不应该存储在缓存中的其他 HTTP 头部。例如，在某些情况下，阻止 cookie 存储在缓存中是有意义的。

CacheIgnoreHeaders 接受一个以空格分隔的 HTTP 头部列表，这些头部不应该存储在缓存中。如果只需要存储逐跳头部（符合 RFC 2616 的行为），则可以将 CacheIgnoreHeaders 设置为 None。

CacheIgnoreHeaders Set-Cookie

CacheIgnoreHeaders None

CacheIgnoreNoLastMod 指令

通常，没有最后修改日期的文档不会被缓存。在某些情况下，最后修改日期会被删除（例如，在 mod_include 处理期间）或根本没有提供。 CacheIgnoreNoLastMod 指令提供了一种方法来指定没有最后修改日期的文档应该被考虑缓存，即使没有最后修改日期。如果文档没有提供最后修改日期或过期日期，则将使用 CacheDefaultExpire 指令指定的值来生成过期日期。

CacheIgnoreNoLastMod On

CacheIgnoreQueryString 指令

通常，带有查询字符串参数的请求会针对每个唯一的查询字符串单独缓存。这符合 RFC 2616/13.9，只有在指定了过期时间的情况下才会执行。 CacheIgnoreQueryString 指令告诉缓存即使没有指定过期时间也要缓存请求，并且即使查询字符串不同也要使用缓存的回复进行回复。从缓存的角度来看，当启用此指令时，请求被视为没有查询字符串。

CacheIgnoreQueryString On

CacheIgnoreURLSessionIdentifiers 指令

有时应用程序会将会话标识符编码到 URL 中，如下面的示例所示

• /someapplication/image.gif;jsessionid=123456789
• /someapplication/image.gif?PHPSESSIONID=12345678

这会导致可缓存资源针对每个会话单独存储，这通常是不希望的。 CacheIgnoreURLSessionIdentifiers 允许定义一个标识符列表，这些标识符将从用于标识缓存中实体的键中删除，这样可缓存资源就不会针对每个会话单独存储。

CacheIgnoreURLSessionIdentifiers None 清除忽略的标识符列表。否则，每个标识符都会被添加到列表中。

CacheIgnoreURLSessionIdentifiers jsessionid

CacheIgnoreURLSessionIdentifiers None

CacheKeyBaseURL 指令

当指定 CacheKeyBaseURL 指令时，提供的 URL 将用作基 URL 来计算反向代理配置中缓存键的 URL。当没有指定时，将使用当前虚拟主机的方案、主机名和端口来构建缓存键。当存在机器集群并且所有缓存条目都应该在同一个缓存键下缓存时，可以使用此指令指定一个新的基 URL。

# Override the base URL of the cache key.
CacheKeyBaseURL "http://www.example.com/"

CacheLastModifiedFactor 指令

如果文档没有提供过期日期，但提供了最后修改日期，则可以根据文档最后修改的时间来计算过期日期。 CacheLastModifiedFactor 指令指定一个 factor 用于根据以下公式生成此过期日期： expiry-period = time-since-last-modified-date * factor expiry-date = current-date + expiry-period 例如，如果文档最后修改时间是 10 小时前，并且 factor 是 0.1，则过期时间将设置为 10*0.1 = 1 小时。如果当前时间是下午 3:00，则计算出的过期日期将是下午 3:00 + 1 小时 = 下午 4:00。如果过期时间超过 CacheMaxExpire 设置的时间，则后者优先。

CacheLastModifiedFactor 0.5

CacheLock 指令

CacheLock 指令为给定的 URL 空间启用雷群锁。

在最小配置中，以下指令是为默认系统临时目录启用雷群锁所需的一切。

# Enable cache lock
CacheLock on

CacheLockMaxAge 指令

CacheLockMaxAge 指令指定任何缓存锁的最大年龄。

比此值（以秒为单位）更旧的锁将被忽略，下一个传入的请求将有机会重新建立锁。此机制可以防止缓慢的客户端花费过长时间来刷新实体。

CacheLockPath 指令

CacheLockPath 指令允许您指定创建锁的目录。默认情况下，使用系统的临时文件夹。锁由仅存在于正在飞行的过时 URL 的空文件组成，因此比传统的磁盘缓存消耗的资源要少得多。

CacheMaxExpire 指令

CacheMaxExpire 指令指定可缓存 HTTP 文档在不检查源服务器的情况下保留的最大秒数。因此，文档最多会过时此秒数。即使文档提供了过期日期，也会强制执行此最大值。

CacheMaxExpire 604800

CacheMinExpire 指令

CacheMinExpire 指令指定可缓存 HTTP 文档在不检查源服务器的情况下保留的最小秒数。这仅在文档没有提供有效的过期时间时使用。

CacheMinExpire 3600

CacheQuickHandler 指令

CacheQuickHandler 指令控制处理缓存的阶段。

在默认启用的配置中，缓存在快速处理程序阶段内运行。此阶段会缩短大多数服务器处理过程，并且代表了典型服务器最有效的运行模式。缓存**直接连接到**服务器的前面，并且避免了大多数服务器处理过程。

当禁用时，缓存作为正常的处理程序运行，并且在处理服务器请求时会受到所有阶段的限制。虽然此模式比默认模式慢，但它允许在需要完整处理的情况下使用缓存，例如，当内容受授权限制时。

# Run cache as a normal handler
CacheQuickHandler off

此外，当快速处理程序被禁用时，管理员可以通过将**CACHE**过滤器添加到链中来选择在过滤器链中的确切位置执行缓存。

# Cache content before mod_include and mod_deflate
CacheQuickHandler off
AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html

如果 CACHE 过滤器被指定多次，则最后一个实例将应用。

CacheStaleOnError 指令

当 CacheStaleOnError 指令被打开，并且缓存中存在陈旧数据时，缓存将通过返回陈旧数据而不是 5xx 响应来响应来自后端的 5xx 响应。虽然客户端发送的 Cache-Control 头部将被尊重，并且按要求将原始 5xx 响应返回给客户端，但返回给客户端的 5xx 响应不会使缓存中的内容失效。

# Serve stale data on error.
CacheStaleOnError on

CacheStoreExpired 指令

从 httpd 2.2.4 开始，已经过期的响应不会存储在缓存中。 CacheStoreExpired 指令允许覆盖此行为。 CacheStoreExpired On 告诉服务器尝试缓存资源，即使它已经过时。后续请求将触发对源服务器的 If-Modified-Since 请求，如果后端资源没有改变，则响应可能会从缓存中满足。

CacheStoreExpired On

CacheStoreNoStore 指令

通常，带有 Cache-Control: no-store 头部值的请求或响应不会存储在缓存中。 CacheStoreNoStore 指令允许覆盖此行为。 CacheStoreNoStore On 告诉服务器尝试缓存资源，即使它包含 no-store 头部值。需要授权的资源**永远不会**被缓存。

CacheStoreNoStore On

另请参阅

• CacheIgnoreCacheControl
• CacheStorePrivate

CacheStorePrivate 指令

通常，带有 Cache-Control: private 头值的响应不会存储在缓存中。CacheStorePrivate 指令允许覆盖此行为。CacheStorePrivate On 告诉服务器尝试缓存资源，即使它包含私有头值。需要授权的资源将永远不会被缓存。

CacheStorePrivate On

另请参阅

• CacheIgnoreCacheControl
• CacheStoreNoStore