Apache模块mod_cache

CacheDefaultExpire 指令

该CacheDefaultExpire指令指定了默认时间（以秒为单位），如果文档没有提供到期日期或最后修改日期，则该默认时间以秒为单位。用CacheMaxExpire 伪指令指定的值不会覆盖此设置。

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 网址字符串。

CacheDisable "/local_files"

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

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

该no-cache环境变量可以设置禁用缓存在2.2.12及以后的版本更细粒度的资源集合。

也可以看看

• Apache中的环境变量

CacheEnable 指令

该CacheEnable指令指示 mod_cache将url缓存在url-string或以下 。高速缓存存储管理器由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/"

该no-cache环境变量可以设置禁用缓存在2.2.12及以后的版本更细粒度的资源集合。

也可以看看

• Apache中的环境变量

CacheHeader 指令

当该CacheHeader指令打开时，X-Cache标头将添加到响应中，并带有该响应的缓存状态。如果使用普通处理程序，则该指令可能出现在<Directory> 或<Location>指令内。如果使用快速处理程序，则此伪指令必须出现在服务器或虚拟主机上下文中，否则设置将被忽略。

击中

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

重新验证

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

小姐

该实体是从上游服务器获取的，而不是从缓存提供的。

# Enable the X-Cache header
CacheHeader on

X-Cache: HIT from localhost

CacheIgnoreCacheControl 指令

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

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伪指令根据以下公式指定要在该到期日期的生成中使用的 因子： 例如，如果文档最后一次修改是在10小时前，并且 因子为0.1，则到期期限将设置为10 * 0.1 = 1小时。如果当前时间是3:00 pm，则计算的到期日期将是3:00 pm + 1hour = 4:00 pm。如果到期期限比设置的期限长 ，则后者优先。expiry-period = time-since-last-modified-date * factor expiry-date = current-date + expiry-periodCacheMaxExpire

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开启告诉服务器尝试缓存资源（如果陈旧）。后续请求将触发原始服务器的If-Modified-Since请求，并且如果后端资源未更改，则可以从缓存中满足响应。

CacheStoreExpired On

CacheStoreNoStore 指令

通常，带有Cache-Control: no-store标头值的请求或响应不会存储在缓存中。该 CacheStoreNoStore指令允许覆盖此行为。 CacheStoreNoStoreOn指示服务器尝试缓存资源，即使该资源包含无存储标头值也是如此。需要授权的资源将 永远不会被缓存。

CacheStoreNoStore On

也可以看看

• CacheIgnoreCacheControl
• CacheStorePrivate

CacheStorePrivate 指令

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

CacheStorePrivate On

也可以看看

• CacheIgnoreCacheControl
• CacheStoreNoStore