From 9cfcd5144d3dad3766d7a369e3e8f922a8ee6dc1 Mon Sep 17 00:00:00 2001 From: Artyom Liou <10079456+artyomliou@users.noreply.github.com> Date: Tue, 27 Apr 2021 09:14:33 +0800 Subject: http/headers/cache-control (zh-TW translation) (#658) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Cache-Control (zh-TW translation) * fix: 移除多餘空白、替換括號、略為修正譯文 --- .../web/http/headers/cache-control/index.html | 219 +++++++++++++++++++++ 1 file changed, 219 insertions(+) create mode 100644 files/zh-tw/web/http/headers/cache-control/index.html (limited to 'files/zh-tw/web/http') diff --git a/files/zh-tw/web/http/headers/cache-control/index.html b/files/zh-tw/web/http/headers/cache-control/index.html new file mode 100644 index 0000000000..f52d0c9c0a --- /dev/null +++ b/files/zh-tw/web/http/headers/cache-control/index.html @@ -0,0 +1,219 @@ +--- +title: Cache-Control +slug: Web/HTTP/Headers/Cache-Control +tags: + - Cache-Control + - General Header + - HTTP + - HTTP Header + - Reference +--- +
{{HTTPSidebar}}
+ +

Cache-Control 標頭中的指令用來控制 HTTP 請求、回應的快取行為。HTTP 請求跟回應可以擁有不同的快取控制指令。

+ + + + + + + + + + + + + + + + +
Header type{{Glossary("General header")}}
{{Glossary("Forbidden header name")}}no
{{Glossary("CORS-safelisted response header")}}yes
+ +

語法

+ +

快取指令必須遵守這些規則：

+ + + +

請求用指令

+ +

可以在 HTTP 請求中使用的標準 Cache-Control 指令

+ +
Cache-Control: max-age=<秒數>
+Cache-Control: max-stale[=<秒數>]
+Cache-Control: min-fresh=<秒數>
+Cache-Control: no-cache
+Cache-Control: no-store
+Cache-Control: no-transform
+Cache-Control: only-if-cached
+
+ +

回應用指令

+ +

可以在 HTTP 回應中使用的標準 Cache-Control 指令

+ +
Cache-Control: must-revalidate
+Cache-Control: no-cache
+Cache-Control: no-store
+Cache-Control: no-transform
+Cache-Control: public
+Cache-Control: private
+Cache-Control: proxy-revalidate
+Cache-Control: max-age=<秒數>
+Cache-Control: s-maxage=<秒數>
+
+ +

擴充 Cache-Control 指令

+ +

這些擴充的 Cache-Control 指令不是 HTTP 快取的核心標準。使用前請檢查相容性，客戶端會直接忽略不支援的指令。

+ +
Cache-Control: immutable
+Cache-Control: stale-while-revalidate=<秒數>
+Cache-Control: stale-if-error=<秒數>
+
+ +

指令

+ +

可快取性

+ +

這些指令定義 HTTP 請求/回應是否可以做快取、儲存在哪，以及使用前是否要跟後端伺服器做驗證

+ +
+
public
+
此回應可以被任何快取軟體儲存起來，即使它本身通常是不可快取的。
+
private
+
此回應只可以被瀏覽器儲存起來，即使它本身通常是不可快取的。如果你真的不要任何快取軟體儲存你的回應，可以使用 no-store 。這個指令不是用來防止快取軟體儲存回應的。
+
no-cache
+
此回應可以被任何快取軟體儲存起來，即使它本身通常是不可快取的。不過，在使用儲存起來的 HTTP 回應之前，必須必須向後端伺服器做驗證，因此你不能拿 no-cache 跟 immutable 一起使用。如果你真的不要任何快取軟體儲存你的回應，可以使用 no-store 。這個指令不是用來防止快取軟體儲存回應的。
+
no-store
+
此回應不能被任何快取軟體儲存起來。當然它無法防止 先前儲存起來 的回應被回傳。客戶端可以用 max-age=0 來清除快取，並強制向後端伺服器做驗證。（其他指令跟 no-store 一起使用都無效）
+
+ +

過期

+ +
+
max-age=<秒數>
+
快取有效的最大時間。跟 Expires 不一樣，這個指令是相對於請求當下的時間。
+
s-maxage=<秒數>
+
覆寫 max-age 或者 Expires 標頭，不過只對共用快取軟體生效（比如 nginx）。私有快取會無視這個指令。
+
max-stale[=<秒數>]
+
表示客戶端可以接受過期回應。可以宣告客戶端最多能接受過期多久。
+
min-fresh=<秒數>
+
表示客戶端想要有效時間至少在指定秒數以上的回應。
+
stale-while-revalidate=<秒數> {{Experimental_Inline}}
+
表示客戶端可以接受過期回應，但同時在背景檢查最新版本。秒數用來控制客戶端最多能接受過期多久。何時過期取決於 max-age 的值。想了解更多細節請到 "Keeping things fresh with stale-while-revalidate" 。
+
stale-if-error=<秒數> {{Experimental_Inline}}
+
表示客戶端會執行驗證，若驗證錯誤了就直接使用過期回應。秒數用來控制客戶端最多能接受過期多久。
+
+ +

驗證與重新讀取

+ +
+
must-revalidate
+
表示一旦過期，必須向後端伺服器做驗證。
+
proxy-revalidate
+
跟 must-revalidate 類似，不過只對共用快取軟體生效（比如 nginx）。私有快取會無視這個指令。
+
immutable
+
表示回應內容不會改變 。這個資源不會過期，因此即使使用者手動重新整理頁面，客戶端也不會用驗證標頭 （比如 If-None-Match 或 If-Modified-Since）。 Clients that aren't aware of this extension must ignore them as per the HTTP specification. 在 Firefox 中， immutable 只有在使用 https:// 時會生效。想知道更多資訊，可以閱讀這篇文章。
+
+ +

其他

+ +
+
no-transform
+
位於中間的快取軟體或代理軟體不能修改回應內容、{{HTTPHeader("Content-Encoding")}}、{{HTTPHeader("Content-Range")}}、{{HTTPHeader("Content-Type")}}。因此它可能造成某些代理軟體或瀏覽器的功能失效，比如說 Google’s Web Light可以替很慢的網路事先壓縮圖片。
+
only-if-cached
+
由客戶端設定，表示不想經由網路得到回應。所以快取軟體可能會回傳先前儲存的回應，或者是 {{HTTPStatus("504")}} 狀態碼。使用驗證標頭如 If-None-Match 是沒有意義的。由伺服器在 HTTP 回應中設定 only-if-cached 指令也沒有意義。
+
+ +

範例

+ +

防止被快取

+ +

想要禁止快取一個資源，你可以在回應中設定這個標頭：

+ +
+
Good:
+
+ 
Cache-Control: no-store
+ +
+

這個 no-store 指令使得回應再也不會被儲存，但它無法防止使用先前儲存、而且仍有效的快取。多設定 max-age=0 可以強制執行驗證（也就會清除既有快取）。

+ + 
Cache-Control: no-store, max-age=0
+
+
+
+
Bad:
+
+ 
Cache-Control: private,no-cache,no-store,max-age=0,must-revalidate,pre-check=0,post-check=0
+
+
+ +

快取靜態檔案

+ +

對於那些不會更新的檔案，你可以在回應中使用下列這個激進的標頭。比如說用在圖片、CSS 檔案，以及 JavaScript 檔案。附帶一提，也可以看看 Expires 標頭。

+ +
Cache-Control: public, max-age=604800, immutable
+
+ +

必須執行驗證

+ +

no-cache、max-age=0, must-revalidate 是同樣的意思。
+ 表示客戶端可以儲存資源，但使用它前必須做驗證。這表示每次都會發生 HTTP 請求，不過只要沒過期就不用下載完整內容

+ +
Cache-Control: no-cache
+ +
Cache-Control: max-age=0, must-revalidate
+ +

附帶一提： 這個設定可以在伺服器掛掉的時候使用過期資源

+ +
Cache-Control: max-age=0
+ +

Specifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{RFC(8246, "HTTP Immutable Responses")}}IETF RFC
{{RFC(7234, "Hypertext Transfer Protocol (HTTP/1.1): Caching")}}IETF RFC
{{RFC(5861, "HTTP Cache-Control Extensions for Stale Content")}}IETF RFCInitial definition
+ +

Browser compatibility

+ +

{{Compat("http.headers.Cache-Control")}}

+ +

See also

+ + -- cgit v1.2.3-54-g00ecf