Smarty 快取機制全解析：全域、區塊、區域三種模式實戰教學

前言

Smarty 模板引擎內建強大的快取機制，能大幅降低伺服器負載、提升回應速度。本文將系統介紹全域快取、區塊快取、區域快取三種模式的原理、設定步驟、程式碼範例與避坑指南。

核心設定（三種模式共用）

// 啟用快取
$smarty->caching = true; // 或 1
// 快取目錄（需可寫入）
$smarty->cache_dir = './cache/';
// 快取壽命（秒），-1 為永不過期
$smarty->cache_lifetime = 3600;

1. 全域快取 —— 整頁快取

適用場景

內容較靜態、不依賴使用者狀態的頁面（如首頁、文章列表、靜態內容頁）。

關鍵技巧：動態快取 ID

同一模板若對應多種 URL 參數（如 ?cat=1、?cat=2），預設快取檔名相同會導致內容錯誤。解法：以 REQUEST_URI 產生唯一快取 ID。

$cacheId = md5($_SERVER['REQUEST_URI']); // 含查詢字串
$smarty->display('list.tpl', $cacheId);

原理

Smarty 以 模板名 + 快取 ID 命名快取檔。不同 $cacheId 產生不同快取檔，實現「同模板、多內容」快取。

2. 區塊快取 —— 指定頁面快取、其餘不快取

核心觀念反轉

區塊快取的本質是「區塊不快取」：預設全開快取，再針對特定頁面呼叫 clear_cache() 禁用快取。

實作步驟

// 1.php、2.php 需要快取
$smarty->display('page.tpl', $cacheId); // 正常顯示，會產生快取

// 3.php 不需要快取（如即時儀表板）
$smarty->clear_cache('page.tpl', $cacheId); // 清除/禁用此模板+ID 的快取
$smarty->display('page.tpl'); // 第二參數留空，不產生新快取

注意

• clear_cache() 的模板名、快取 ID 必須與 display() 完全一致。
• 若需動態判斷是否快取，可在邏輯中決定是否呼叫 clear_cache()。

3. 區域快取 —— 同一頁面局部動態、其餘靜態

核心觀念再反轉

區域快取的本質是「區域不快取」：整頁快取，但透過 {insert} 標籤標記特定區塊為「動態區塊」，每次請求即時執行。

實作範例

PHP

$smarty->assign('staticContent', '這段會被快取');
$smarty->display('page.tpl');

page.tpl

{$staticContent}
// 以下區塊不受快取影響，每次重新執行
{insert name='realtime'}

PHP 定義 insert 函式

function insert_realtime() {
    return date('Y-m-d H:i:s'); // 即時時間
}

運作機制

1. Smarty 偵測到 {insert name='xxx'}。
2. 尋找 insert_xxx() 函式並執行。
3. 回傳值直接輸出到模板，不經過快取。
4. 函式名命名規則：insert_ + name 屬性值。

進階技巧與避坑指南

快取群組

$smarty->cache_modified_check = true; // 檢查來源檔案是否變動
$smarty->clear_cache('page.tpl', $cacheId, 'group_name'); // 按群組清除

常見坑點

三種模式選型建議

總結

Smarty 快取三部曲核心口訣：

• 全域：動態 ID 分離參數
• 區塊：clear_cache() 禁用特定頁
• 區域：{insert} 標記動態區塊

善用三種模式組合，能在維持開發彈性的前提下，將頁面回應時間從百毫秒壓縮至幾毫秒，是高流量 PHP 專案的必備優化技能。