YII Framework 緩存系統全解析：多驅動適配、數據/片段/頁面/動態緩存實戰

YII Framework 緩存系統全解析：多驅動適配、數據/片段/頁面/動態緩存實戰

YII 提供統一的緩存組件抽象層，支援 10+ 後端存儲驅動，並實現數據級、片段級、頁面級、動態內容四大緩存模式。本文系統梳理驅動選型、配置、API 使用與進階模式實戰。

一、緩存驅動全景圖

框架內建驅動（framework/caching/）：

核心優勢： 所有驅動繼承 CCache，業務代碼**零修改**即可切換後端。

二、緩存組件配置

APC 示例

'components' => array(
    'cache' => array(
        'class' => 'system.caching.CApcCache',
    ),
),

Memcached 多伺服器示例

'cache' => array(
    'class' => 'CMemCache',
    'servers' => array(
        array('host' => 'server1', 'port' => 11211, 'weight' => 60),
        array('host' => 'server2', 'port' => 11211, 'weight' => 40),
    ),
    'keyPrefix' => 'myapp_',  // 避免鍵衝突
),

三、統一 API 操作（CCache 基類方法）

$cache = Yii::app()->cache;

// 基礎操作
$cache->set($id, $value, $expire=0, $dependency=null);  // 存儲
$cache->get($id);                                        // 讀取
$cache->add($id, $value, $expire, $dependency);          // 僅不存在時存儲
$cache->delete($id);                                     // 刪除
$cache->flush();                                         // 清空所有

// 陣列式訪問（實現 ArrayAccess）
$cache['key'] = $value;  // 等同 set()
$value = $cache['key'];  // 等同 get()

// 批量讀取（支援驅動原生 mget）
$values = $cache->mget(array('key1', 'key2', 'key3'));

四、緩存依賴：智能失效機制

除過期時間外，支援依賴條件變更觸發失效：

使用示例

// 依賴文件變化
$dependency = new CFileCacheDependency('/path/to/config.ini');
Yii::app()->cache->set('config', $data, 3600, $dependency);

// 依賴數據庫最大更新時間
$dependency = new CDbCacheDependency('SELECT MAX(updated_at) FROM post');
Yii::app()->cache->set('post_list', $data, 0, $dependency);

五、四大緩存模式實戰

1. 數據緩存

$key = 'user_profile_' . $userId;
if (($profile = Yii::app()->cache->get($key)) === false) {
    $profile = User::model()->findByPk($userId);
    Yii::app()->cache->set($key, $profile, 3600);
}

2. 片段緩存

視圖中緩存頁面局部：

<?php if ($this->beginCache('sidebar', array('duration'=>3600, 'dependency'=>...))) { ?>
    <!-- 昂貴的側邊欄渲染邏輯 -->
    <?php $this->endCache(); ?>
<?php } ?>

進階選項：

• duration：有效秒數（默認 60）
• dependency：依賴對象/配置
• varyByRoute：按路由變化（不同 Controller/Action 獨立緩存）
• varyBySession：按 Session ID 變化（用戶個性化）
• varyByParam：按 GET 參數變化（如 array('id')）
• varyByExpression：按 PHP 表達式結果變化
• requestTypes：限制請求類型（如 array('GET') 僅緩存 GET）

3. 頁面緩存

作為 Action 過濾器，跳過整個視圖渲染：

public function filters() {
    return array(
        array(
            'COutputCache',
            'duration' => 100,
            'varyByParam' => array('id'),
        ),
    );
}

COutputCache 繼承 CFilterWidget，兼具 Widget 與 Filter 雙重身份。

4. 動態內容

頁面/片段緩存中嵌入實時生成內容（如用戶名、購物車數量）：

<?php if ($this->beginCache('page', array('duration'=>3600))) { ?>
    <!-- 靜態內容 -->
    <?php echo $this->renderDynamic(array($this, 'renderUserPanel')); ?>
    <!-- 靜態內容 -->
    <?php $this->endCache(); ?>
<?php } ?>

renderDynamic($callback) 回調可為控制器方法、全局函數或類方法，每次請求實時執行並插入結果。

六、嵌套緩存策略

片段緩存支援嵌套，內層過期不影響外層有效數據；外層過期將重新生成包含內層的完整內容。合理設置不同 duration 實現多級緩存失效策略。

七、最佳實踐建議

1. 緩存鍵規範：採用 模塊:實體:動作:標識 格式（如 user:profile:view:123），配合 keyPrefix 隔離環境
2. 緩存穿透/擊穿/雪崩防護：空值緩存短期、互斥鎖重建、隨機過期時間分散
3. 依賴優於過期：業務數據變更觸發失效優於固定 TTL，保證一致性
4. 監控指標：命中率、平均延遲、內存/磁盤佔用、驅動錯誤率
5. 避免緩存大對象圖：序列化開銷大，拆分為細粒度鍵值

八、相關專題延伸

• YII Framework 框架教程之日誌用法詳解
• YII Framework 框架教程之安全方案詳解
• YII Framework 框架教程之國際化實現方法
• YII Framework 框架教程之異常處理詳解