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-string 或其下層的 URL。

CacheDisable "/local_files"

如果在 <Location> 指令中使用，則需要在 Location 下方指定路徑，或者如果使用「開啟」一詞，則會停用整個位置的快取。

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

可以設定 no-cache 環境變數，以在 2.2.12 及更高版本中停用更細粒度資源集的快取。

另請參閱

• 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 指令的順序決定。 <Location> 或 <LocationMatch> 區段中的 CacheEnable 指令會在全域定義的 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> 指令中。如果使用快速處理程式，則此指令必須出現在伺服器或虛擬主機上下文中，否則該設定將被忽略。

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 開啟 告訴伺服器即使請求包含 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 設定為 無。

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，則計算出的到期日期將為下午 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