PEAR Cache_Lite 實戰教學：頁面片段快取、標籤群組失效、生命周期控制

安裝

pear install Cache_Lite
# 或 Composer
composer require pear/cache_lite

核心類與選項

通用選項

$options = [
    'cacheDir'           => '/var/www/cache/',     // 絕對路徑，需可寫
    'lifeTime'           => 3600,                  // 秒，0=永久
    'fileLocking'        => true,                  // 檔案鎖防並發損壞
    'writeControl'       => true,                  // 寫入後驗證讀取
    'readControl'        => true,                  // 讀取時驗證校驗和
    'readControlType'    => 'crc32',               // 'md5'|'crc32'|'strlen'
    'hashedDirectoryLevel' => 2,                   // 子目錄層級分散檔案 (inode 優化)
    'automaticCleaningFactor' => 100,              // 1% 機率觸發自動清理過期
    'pearErrorMode'      => CACHE_LITE_ERROR_DIE,  // 錯誤模式
];

範例 1：資料快取 (Cache_Lite)

require_once 'Cache/Lite.php';
$cache = new Cache_Lite($options);
$id = 'homepage_articles';

if ($data = $cache->get($id)) {
    echo "From cache\n";
} else {
    echo "Rebuilding...\n";
    $data = fetchArticlesFromDB(); // 你的查詢邏輯
    $cache->save($data, $id);
}
renderTemplate($data);

範例 2：輸出快取 (Cache_Lite_Output) — 含模板渲染

require_once 'Cache/Lite/Output.php';
$cache = new Cache_Lite_Output($options);
$id = 'homepage_html';

if (!$cache->start($id)) {
    // 快取未命中，執行業務邏輯 + 模板
    $articles = fetchArticlesFromDB();
    include 'templates/homepage.php'; // 直接 echo 輸出
    $cache->end(); // 自動捕獲輸出並存檔
}
// 命中時 start() 直接輸出快取內容並返回 true，跳過 if 區塊

進階：標籤群組失效 (Cache_Lite::clean)

// 存入時指定群組
$cache->save($data, 'article_123', ['articles', 'user_456']);

// 更新文章 123 後，只清除相關群組
$cache->clean('articles');      // 清除所有文章快取
$cache->clean('user_456');      // 清除用戶 456 相關快取
$cache->clean();                // 清除所有 (慎用)

效能與避坑指南

1. 快取目錄放 tmpfs (記憶體盤)：`mount -t tmpfs -o size=512m tmpfs /var/www/cache` → 近乎記憶體速度，重啟自動清理。
2. 避免 `lifeTime=0` 永久快取：配合標籤失效或 `Cache_Lite_File` 監控來源檔變更。
3. 高併發熱點鍵：單飛重建 (Single Flight) — 用 `fileLocking` + 額外 `lock` 檔或 Redis `SETNX` 只讓一個進程重建，其他進程等待或返回舊資料。
4. 大對象 (>1MB)：改用 Redis/Memcached，檔案 I/O 成瓶頸。
5. 序列化改用 igbinary：`$cache->setOption('serializer', 'igbinary')` (需編譯支援)，體積減 30%、速度提升。

適用場景對比