如何搭配apcu_fetch 和apcu_exists 實現緩存預加載功能？

gitbox 2025-09-16
<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// ---------------------------</span></span><span>
</span><span><span class="hljs-comment">// 以下部分與文章內容無關</span></span><span>
</span><span><span class="hljs-comment">// 可視作 PHP 文件開頭的標準聲明或註釋</span></span><span>
</span><span><span class="hljs-comment">// ---------------------------</span></span><span>

</span><span><span class="hljs-comment">// ---------------------------</span></span><span>
</span><span><span class="hljs-comment">// 正文開始</span></span><span>
</span><span><span class="hljs-comment">// ---------------------------</span></span><span>

<span class="hljs-comment">/**
 * 如何搭配 apcu_fetch 和 apcu_exists 實現緩存預加載功能？
 * 
 * 在 PHP 中使用 APCu（Alternative PHP Cache User）可以極大提升應用性能，
 * 尤其是對於頻繁讀取的數據，如配置文件、熱門查詢結果等。
 * 為了優化緩存的命中率，可以結合 apcu_exists 和 apcu_fetch 來實現緩存預加載。
 * 
 * 1. 理解 apcu_exists 和 apcu_fetch
 * 
 * - apcu_exists($key) ：用於判斷緩存中是否存在指定的 key。
 * - apcu_fetch($key, &amp;$success) ：嘗試從緩存中獲取 key 對應的值，如果存在則返回對應值，否則返回 false。$success 參數會被設置為 true 或 false。
 * 
 * 2. 緩存預加載的思路
 * 
 * 緩存預加載的核心目標是：如果緩存不存在，就提前生成數據並寫入緩存，從而避免每次請求都重新計算或查詢數據庫。
 * 
 * 典型流程如下：
 * 
 * a. 檢查緩存是否存在：
 *    使用 apcu_exists($key) 判斷，如果返回 false，則說明緩存未命中，需要預加載。
 * 
 * b. 預加載數據：
 *    根據業務邏輯從數據庫或其他數據源獲取數據。
 * 
 * c. 寫入緩存：
 *    使用 apcu_store($key, $value, $ttl) 將數據存入緩存，其中 $ttl 是緩存有效期。
 * 
 * d. 獲取緩存：
 *    使用 apcu_fetch($key) 來讀取緩存，这样保证即使并发请求中有一个先寫入緩存，後續請求都能直接獲取。
 * 
 * 3. 示例代碼
 */</span>

</span><span><span class="hljs-variable">$cacheKey</span></span><span> = </span><span><span class="hljs-string">'user_config'</span></span><span>;
</span><span><span class="hljs-variable">$cacheTTL</span></span><span> = </span><span><span class="hljs-number">3600</span></span><span>; </span><span><span class="hljs-comment">// 快取 1 小時</span></span><span>

</span><span><span class="hljs-comment">// 檢查緩存是否存在</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">apcu_exists</span></span><span>(</span><span><span class="hljs-variable">$cacheKey</span></span><span>)) {
    </span><span><span class="hljs-comment">// 預加載數據，例如從數據庫獲取</span></span><span>
    </span><span><span class="hljs-variable">$data</span></span><span> = [
        </span><span><span class="hljs-string">'theme'</span></span><span> =&gt; </span><span><span class="hljs-string">'dark'</span></span><span>,
        </span><span><span class="hljs-string">'language'</span></span><span> =&gt; </span><span><span class="hljs-string">'zh-CN'</span></span><span>,
        </span><span><span class="hljs-string">'items_per_page'</span></span><span> =&gt; </span><span><span class="hljs-number">20</span></span><span>
    ];
    </span><span><span class="hljs-comment">// 寫入緩存</span></span><span>
    </span><span><span class="hljs-title function_ invoke__">apcu_store</span></span><span>(</span><span><span class="hljs-variable">$cacheKey</span></span><span>, </span><span><span class="hljs-variable">$data</span></span><span>, </span><span><span class="hljs-variable">$cacheTTL</span></span><span>);
}

</span><span><span class="hljs-comment">// 从快取中获取数据</span></span><span>
</span><span><span class="hljs-variable">$data</span></span><span> = </span><span><span class="hljs-title function_ invoke__">apcu_fetch</span></span><span>(</span><span><span class="hljs-variable">$cacheKey</span></span><span>, </span><span><span class="hljs-variable">$success</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$success</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"快取加载成功: "</span></span><span>;
    </span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$data</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"快取获取失败，需要重新生成數據"</span></span><span>;
}

<span class="hljs-comment">/**
 * 4. 注意事項
 * 
 * - 避免在高并发场景下重复生成快取，可以使用鎖機製或 check-and-set 方案。
 * - 定期清理过期快取，避免佔用過多內存。
 * - apcu_exists 和 apcu_fetch 可以組合使用，也可以直接使用 apcu_fetch 並通過返回的 $success 判斷是否存在，这样可以减少一次快取访问。
 * 
 * 總結：
 * 搭配 apcu_exists 和 apcu_fetch 可以有效实现快取预加载，提升 PHP 應用性能。關鍵是：
 * - 先檢查緩存是否存在
 * - 不存在时生成数据并存入快取
 * - 使用 apcu_fetch 獲取緩存内容
 */</span>
 
</span><span><span class="hljs-comment">// ---------------------------</span></span><span>
</span><span><span class="hljs-comment">// 以下部分與文章內容無關</span></span><span>
</span><span><span class="hljs-comment">// 可視作 PHP 文件尾部的結束標記或額外註釋</span></span><span>
</span><span><span class="hljs-comment">// ---------------------------</span></span><span>

</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>
apcu_exists