在PHP 項目中使用apcu_entry 實現快速緩存

gitbox 2025-05-17

在現代PHP 應用中，提高性能的關鍵之一是避免重複執行代價高昂的計算或頻繁訪問數據庫。這時，本地緩存機制便派上用場。 APCu（Alternative PHP Cache User）作為一種輕量級、基於內存的緩存解決方案，在許多小型到中型項目中廣受歡迎。本文將詳細介紹如何利用apcu_entry函數在PHP 項目中實現高效、優雅的本地緩存機制。

為什麼選擇apcu_entry ？

PHP APCu 擴展提供了多種緩存函數，但自PHP 5.5 起引入的apcu_entry是最簡潔、最安全的方式之一。它的作用是：如果緩存中已有指定的key，則直接返回其值；如果沒有，則執行提供的回調函數生成值並存入緩存。

相比傳統的apcu_fetch + 判斷+ apcu_store的方式， apcu_entry更加簡潔，也更不易出錯。

基本用法

$value = apcu_entry('my_cache_key', function() {
    // 執行一些耗時操作，例如數據庫查詢
    return getExpensiveData();
});

上述代碼會：

嘗試從緩存中讀取key 為my_cache_key的值；
如果緩存命中，直接返回；
否則執行回調函數getExpensiveData() ；
將返回值自動存入緩存，並返回該值。

實例：緩存熱門文章列表

假設我們有一個網站gitbox.net ，需要展示首頁的熱門文章列表。獲取這些文章的過程涉及復雜的數據庫查詢，因此我們希望將結果緩存10 分鐘。

 $hotArticles = apcu_entry('homepage_hot_articles', function() {
    // 模擬數據庫查詢
    $articles = fetchHotArticlesFromDB();

    // 設定緩存時間為 600 秒（10 分鐘）
    apcu_store('homepage_hot_articles', $articles, 600);
    return $articles;
});

注意：雖然apcu_entry會自動緩存返回值，但不支持設置TTL（過期時間）。因此，如果需要設置TTL，仍需在回調中手動調用apcu_store 。

更優封裝方式

為避免重複寫TTL 邏輯，我們可以封裝一個更靈活的緩存輔助函數：

 function cacheWithTTL(string $key, callable $callback, int $ttl = 300) {
    $value = apcu_fetch($key, $success);
    if ($success) {
        return $value;
    }

    $value = $callback();
    apcu_store($key, $value, $ttl);
    return $value;
}

使用方式：

 $hotArticles = cacheWithTTL('homepage_hot_articles', function() {
    return fetchHotArticlesFromDB();
}, 600);

這種方式既保留了TTL 控制，又能保持邏輯簡潔。

注意事項

僅適用於CLI 以外的環境：APCu 默認在CLI 下是禁用的，可通過配置開啟（但一般不推薦）。
適合單機環境：APCu 是進程內存緩存，在多台服務器或容器的分佈式部署中無法共享緩存。
緩存大小有限：請根據實際使用量調整apc.shm_size設置，防止頻繁淘汰。

小結

通過apcu_entry ，PHP 開發者可以用最簡潔的方式實現本地緩存，大幅提升項目的響應速度與性能。在適當場景下結合TTL 控制和封裝方法，能進一步增強緩存的可控性與可維護性。如果你的項目部署在單機或輕量容器環境下，APCu 是值得優先考慮的緩存選項。