SAE 部署 Smarty 模板引擎：編譯緩存導向 Memcache 完整配置指南

Sina App Engine (SAE) 禁用本地文件寫入，導致 Smarty 編譯緩存無法落盤。官方方案是將 compile_dir、cache_dir 指向 SAE Memcache 協議（saemc://）。本文提供完整配置步驟、代碼示例與避坑指南。

問題現象

SmartyException: unable to write file ./web/templates_c/wrt4e95555280ef1

原因：SAE 文件系統只讀，Smarty 嘗試寫入編譯緩存失敗。

解決方案：三步走

1. 開通 SAE Memcache 服務

• 登入 SAE 管理控制台 → 應用管理 → 服務管理 → Memcache；
• 點擊「初始化」分配容量（免費額度通常足夠）；
• 記錄服務名稱（默認即為 memcache）。

2. 修改 Smarty 配置

require_once 'Smarty.class.php';
$smarty = new Smarty();

// 關鍵：指向 SAE Memcache 協議
$smarty->compile_dir = 'saemc://smartytpl/';
$smarty->cache_dir   = 'saemc://smartytpl/';

// 必須關閉編譯鎖定，因為 saemc 不支援 touch() 操作
$smarty->compile_locking = false;

// 其他常規設置
$smarty->template_dir = __DIR__ . '/templates/';
$smarty->left_delimiter  = '{';
$smarty->right_delimiter = '}';
$smarty->caching = true;
$smarty->cache_lifetime = 3600;

3. 驗證運行

• 訪問頁面，首次會觸發模板編譯並存入 Memcache；
• 刷新頁面，應直接從 Memcache 讀取編譯緩存，響應加速；
• SAE 管理控制台 → Memcache 監控，可看到 smartytpl/ 相關 Key 的讀寫統計。

原理深度解析

• saemc:// 是 SAE 封裝的流封裝協議，底層調用 Memcache API；
• Smarty 將編譯後的 PHP 代碼序列化存入 Memcache，Key 格式類似 smartytpl/%s；
• compile_locking = false 避免 Smarty 嘗試 touch() 更新時間戳（Memcache 不支援文件系統元操作）；
• 緩存過期由 cache_lifetime 控制，SAE Memcache 也會按 LRU 淘汰。

進階優化建議

1. 區分編譯/緩存命名空間：saemc://smartytpl_compile/、saemc://smartytpl_cache/，便於監控；
2. 預熱編譯緩存：部署腳本中遍歷模板調用 $smarty->fetch()，避免首請求慢；
3. 模板變更自動失效：SAE 部署腳本中調用 $smarty->clear_compiled_template()；
4. 大模板分片：超大模板編譯後可能超過 Memcache 單項限制（1MB/4MB），拆分為子模板 {include}；
5. 本地開發環境兼容：

if (defined('SAE_TMP_PATH')) {
    $smarty->compile_dir = 'saemc://smartytpl/';
    $smarty->cache_dir   = 'saemc://smartytpl/';
    $smarty->compile_locking = false;
} else {
    $smarty->compile_dir = __DIR__ . '/templates_c/';
    $smarty->cache_dir   = __DIR__ . '/cache/';
}

常見問題排查

替代方案對比

對於存量 Smarty 專案，saemc:// 方案是遷移成本最低、風險最小的選擇。