WP Super Cache

外掛說明

此外掛會從動態 WordPress 網站產生靜態 HTML 檔案。產生 HTML 檔案後，網頁伺服器將直接提供該檔案，而不需要執行相對龐大且耗費資源的 WordPress PHP 指令碼。

靜態 HTML 檔案將提供給絕大多數的使用者：

• 未登入的使用者。
• 未在你的網站留下留言的使用者。
• 或是未檢視過受密碼保護文章的使用者。

99% 的訪客將取得靜態 HTML 檔案。一個快取檔案可以提供數千次。其他訪客則會取得依其造訪量身打造的自訂快取檔案。如果他們已登入或留過留言，系統就會向他們顯示這些詳細資料並為其快取。

此外掛以 3 種方式提供快取檔案 (依速度排序)：

1. 專家模式。最快速的方法是使用 Apache mod_rewrite (或網頁伺服器支援的類似模組) 提供「supercached」靜態 HTML 檔案。這會完全繞過 PHP，速度極快。如果你的伺服器遭遇大量流量衝擊，由於請求更「輕量」，因此更能從容應對。這需要 Apache mod_rewrite 模組 (如果你使用自訂永久連結，通常已經安裝)，且需要修改 .htaccess 檔案，這具有風險，如果修改不正確可能會導致網站無法運作。
2. 簡易模式。Supercache 靜態檔案可以由 PHP 提供，這是使用此外掛的推薦方式。外掛如果找到「supercached」檔案就會直接提供，其速度幾乎與 mod_rewrite 方式一樣快。由於不需要變更 .htaccess 檔案，因此設定更容易。你仍然需要自訂永久連結。在此快取模式下，你可以讓頁面的部分內容維持動態。
3. WP-Cache 快取。這主要用於為已知使用者、帶有參數的 URL 以及網址摘要快取頁面。已知使用者是指已登入的使用者、留下留言的訪客，或是應向其顯示個別使用者自訂資料的人員。這是最具彈性的快取方式，速度稍微慢一點。如果停用了 supercache，WP-Cache 快取也會快取未知使用者的造訪。在此模式下，頁面也可以包含動態部分。此模式始終保持啟用，但你可以分別停用已知使用者、帶有參數的 URL 或網址摘要的快取。如果你只想使用 WP-Cache 快取，請在 wp-config.php 中將常數「DISABLE_SUPERCACHE」設為 1。

如果你不習慣編輯 PHP 檔案，請使用簡易模式。它設定簡單且速度極快。

建議設定

1. 簡易快取。
2. 壓縮頁面。
3. 不要為已知使用者快取頁面。
4. 重建快取。
5. CDN 支援。
6. 額外首頁檢查。

快取回收是指清理過期與陳舊快取檔案的動作。逾期時間沒有絕對正確的值，但 1800 秒是個不錯的起點。

請考慮刪除「拒絕的使用者代理」文字方塊中的內容，以允許搜尋引擎為你快取檔案。

盡可能預先載入越多的文章，並啟用「預先載入模式」。此時舊快取檔案的快取回收功能將會停用。如果你不在意側邊欄小工具是否頻繁更新，可將預先載入間隔設為 2880 分鐘 (2 天)，這樣所有文章就不會太頻繁重新快取。當進行預先載入時，正在重新整理的文章快取檔案將被刪除並重新產生。隨後會對所有舊檔案執行快取回收以清除過期快取檔案。
即使啟用了預先載入模式，修改文章或發表留言時仍會刪除快取檔案。

開發

• 此外掛的主動開發工作在 GitHub 上進行。
• 此外掛多國語言的翻譯工作在翻譯頁面上進行。

說明文件

如果你需要比下列更多的資訊，可以查看 Wiki 或開發人員說明文件。

預先載入

你可以透過預先載入為網站的文章、分類與標籤產生快取檔案。預先載入會逐一造訪網站的每個頁面並隨之產生快取頁面，就像網站的任何其他訪客一樣。由於此功能的循序性質，如果文章數量較多，預先載入整個網站可能需要一些時間。
為了提高預先載入的效率，停用快取回收以避免刪除較舊的快取檔案可能會有所幫助。這可以透過在設定中啟用「預先載入模式」來完成。但請注意，頁面最終仍會過期，不過透過送出留言或編輯文章進行的更新將會清除部分快取。

快取回收

隨著時間推移，快取目錄會被填滿，佔用伺服器空間。如果空間有限或按容量計費，或者你擔心網站的快取頁面會過期，就必須執行快取回收。快取回收會定期進行並刪除快取目錄中的舊檔案。在進階設定頁面上，你可以指定：
1. 快取逾期時間。快取檔案被視為新的時間長度。在此時間之後，它們就已過期並可被刪除。
2. 排程器。設定快取回收的執行頻率。
3. 通知電子郵件。你可以收到關於快取回收工作進度的通知。
快取回收設定沒有所謂的對或錯，完全取決於你自己的網站。
如果你的網站定期更新或有留言，請將逾期時間設為 1800 秒，並將計時器設為 600 秒。
如果你的網站大部分為靜態內容，你可以輸入 0 作為逾期時間來停用快取回收，或是使用非常大的逾期時間值。

快取目錄 (通常為 wp-content/cache/) 僅供暫存檔案使用。切勿將重要檔案或指向重要檔案或目錄的符號連結放在該目錄中。若此外掛具備寫入權限，這些檔案將會被刪除。

CDN

內容傳遞網路 (CDN) 通常是分佈在世界各地的電腦網路，利用靠近你的伺服器以更快的速度提供網站內容。圖片、JavaScript 與 CSS 檔案等靜態檔案可以透過這些網路提供，藉此加快網站載入速度。你也可以使用網域的子網域來提供靜態檔案，以建立「窮人版 CDN」。

OSSDL CDN off-linker 已整合至 WP Super Cache 中以提供基本 CDN 支援。其運作方式為重寫伺服器上 wp-content 與 wp-includes 中的檔案 URL (不含 .php 檔案)，使其指向不同的主機名稱。許多 CDN 支援回源擷取 (origin pull)。這表示 CDN 會在首次被請求時自動從你的伺服器下載該檔案，並在可設定的時間內持續提供該檔案，之後才會再次從伺服器下載。

請在外掛設定頁面的「CDN」分頁中設定此項。這是進階技術，需要對網頁伺服器或 CDN 的運作方式有基本了解。設定 CDN 後，請務必清除檔案快取。

REST API

現在提供了用於存取此外掛設定的 REST API 端點。你必須以具備檢視設定頁面權限的管理員使用者身分通過驗證才能使用。目前尚未有相關文件記錄，但你可以在「rest」目錄中找到處理此部分的所有程式碼。

自訂快取

現在可以使用 add_cacheaction() 函式掛鉤至快取程序。

提供三個掛鉤：

1. 「wp_cache_get_cookies_values」- 修改 WP Cache 使用的金鑰。
2. 「add_cacheaction」- 於 phase2 執行。允許外掛新增 WordPress 掛鉤。
3. 「cache_admin_page」- 於管理後台頁面中執行。用來修改該頁面，例如新增設定選項。

還有一個標準 WordPress 篩選器。使用「do_createsupercache」篩選器
以自訂快取前執行的檢查。該篩選器接受一個參數：
WP-Cache 的 wp_cache_get_cookies_values() 函式輸出。

WP Super Cache 擁有自己的外掛系統，在大部分 WordPress 載入之前載入。你可以將自己的外掛放入 wp-content/plugins/wp-super-cache-plugins 目錄中，或是呼叫帶有該外掛完整路徑的 wpsc_add_plugin( ) 來新增自己的外掛。

用於識別「已知使用者」的 Cookie 可以使用 wpsc_add_cookie( ) 與 wpsc_delete_cookie( ) 進行修改。請參閱 plugins/searchengine.php 作為範例。

疑難排解

如果安裝外掛後無法正常運作，可以檢查以下幾點：

1. wp-content 是否可由網頁伺服器寫入？
2. 是否有 wp-content/wp-cache-config.php？如果沒有，請將檔案 wp-super-cache/wp-cache-config-sample.php 複製為 wp-content/wp-cache-config.php，並確認 WPCACHEHOME 指向正確的位置。
3. 是否有 wp-content/advanced-cache.php？如果沒有，你必須將 wp-super-cache/advanced-cache.php 複製到 wp-content/。你必須編輯該檔案並變更路徑，使其指向 wp-super-cache 資料夾。
4. 如果完全沒有快取頁面，請依照上述建議移除 wp-content/advanced-cache.php 並重新建立。

5. 確認 wp-config.php 中包含下列這行，且位於「require_once(ABSPATH.’wp-settings.php’);」這行的上方：

   define( 'WP_CACHE', true );
   

6. 再次嘗試前往 [設定] -> [WP Super Cache] 頁面並啟用快取。
7. 查看 wp-content/cache/supercache/。那裡是否有目錄與檔案？
8. 你的 php error_log 中是否有任何內容？
9. 如果安裝 Super Cache 後瀏覽器一直要求你儲存檔案，你必須停用 Super Cache 壓縮。請前往 [設定] -> [WP Super Cache] 頁面並在該處停用。
10. 檔案鎖定錯誤 (例如「failed to acquire key 0x152b: Permission denied in…」或「Page not cached by WP Super Cache. Could not get mutex lock.」) 表示你可能必須使用檔案鎖定。請編輯 wp-content/wp-cache-config.php 並取消註解「 = true」，或將 設為不同值。作為最後手段，你也可以從管理後台畫面停用檔案鎖定。
11. 若使用粗粒度檔案鎖定，請確認 cache/wp_cache_mutex.lock 可由網頁伺服器寫入。
12. 快取資料夾不能放在 NFS、Samba 或 NAS 共享空間上，必須位於本機磁碟上。除非快取資料夾位於本機電腦上，否則檔案鎖定與刪除過期檔案將無法正常運作。
13. 如果 WordPress 找不到 wp-cron.php，舊快取檔案的快取回收將無法運作。請檢查 access_logs 中是否有 wp-cron.php 項目，並確認你的主機名稱能解析為網路/網際網路其他伺服器所使用的外部 IP 位址。
14. 如果訪客透過 supercache 看到的是舊頁面，你可能缺少 Apache 模組 (如果未使用 Apache，則為對應模組)。需要 3 個模組：mod_mime、mod_headers 與 mod_expires。後兩個模組特別重要，能確保瀏覽器載入網站既有頁面的新版本。
15. 每頁結尾都出現錯誤訊息「WP Super Cache is installed but broken. The path to wp-cache-phase1.php in wp-content/advanced-cache.php must be fixed!」。請用偏好的編輯器開啟 wp-content/advanced-cache.php 檔案。前往 wp-cache-phase1.php 的路徑是否正確？此檔案通常位於 wp-content/plugins/wp-super-cache/。如果路徑不正確，快取引擎將無法載入。
16. 快取無法運作。重新載入時我網站上的時間戳記一直改變。請檢查 .htaccess 規則中的路徑是否與 supercache 目錄的位置相符。你可能必須寫死該路徑。請嘗試停用 supercache 模式。

17. 如果產生了 supercache 快取檔案卻未提供，請檢查所有 wp-content/cache/supercache 資料夾 (以及 wp-content 快取與 supercache 各資料夾) 和 wp-content/cache/.htaccess 的權限。如果你的 PHP 是以不同於 Apache 的使用者身分執行且權限嚴格，Apache 可能無法讀取由 PHP 產生的快取檔案。若要修正，你必須在 wp-config.php 中加入下列這行 (加在 WP_CACHE 定義上方)，然後清除快取。

    umask( 0022 );
    

18. 如果在此外掛中啟用壓縮後瀏覽器中出現亂碼，可能表示網頁伺服器已經啟用了壓縮。在 Apache 中你必須停用 mod_deflate，或者 PHP 可能啟用了 zlib 壓縮。你可以透過三種方式停用。如果你擁有 root 存取權限，請編輯 php.ini 找到 zlib.output_compression 設定並確認其為「Off」，或是在 .htaccess 中加入這行：

    php_flag zlib.output_compression off
    

    如果這樣沒有作用，請在 wp-config.php 中加入這行：

    ini_set('zlib.output_compression', 0);
    

19. 解除安裝後，如果同時移除了 WordPress mod_rewrite 規則，永久連結可能會失效。請前往 [設定] -> [永久連結] 頁面並重新儲存該表單以重新產生這些規則。
20. 如果你的網站無法載入，請確認 wp-config.php 正確無誤。是否缺少 PHP 開始或結束標籤？
21. 首頁正常，但文章與頁面出現 404？請選取自訂永久連結結構後前往 [設定] -> [永久連結] 並點擊「儲存」。你可能需要手動更新 .htaccess 檔案。

22. 如果網站上的特定字元無法正確顯示，可能是伺服器設定不正確。你必須告知訪客使用的是哪種字元集。請前往 [設定] -> [閱讀] 並複製「頁面與網址摘要的編碼」的值。編輯包含所有 Supercache 與 WordPress 重寫規則的 .htaccess 檔案，並在最頂端加入此設定，將 CHARSET 替換為複製的值 (例如「UTF-8」)

    AddDefaultCharset CHARSET
    

23. 每頁結尾都出現錯誤訊息「WP Super Cache is installed but broken. The constant WPCACHEHOME must be set in the file wp-config.php and point at the WP Super Cache plugin directory。」。你可以刪除 wp-content/advanced-cache.php 並重新載入外掛設定頁面，或是編輯 wp-config.php 尋找 WPCACHEHOME 並確認它指向 wp-super-cache 資料夾。這通常是 wp-content/plugins/wp-super-cache/，但你可能需要該檔案的完整路徑 (因此讓設定頁面自動修復會更簡單)。如果路徑不正確，快取引擎將無法載入。
24. 如果伺服器因為外掛使用的號誌數量過多而遇到問題，是因為使用者使用了檔案鎖定，這是不建議的做法 (但少數使用者需要)。你可以定義常數 WPSC_DISABLE_LOCKING 來全域停用檔案鎖定，或是定義常數 WPSC_REMOVE_SEMAPHORE 以在快取每個頁面後呼叫 sem_remove()，但這似乎會給請求相同號誌的其他程序帶來問題。最好是將其停用。
25. 如果外掛在錯誤的目錄中尋找該檔案，請在 wp-config.php 或 wp-cache-config.php 中將變數 設定為全域 .htaccess 的路徑。如果你的 WordPress 安裝方式較為特殊，可能會發生這種情況。