SmartY 變量調節器失效真兇：一個空格引發的血案

SmartY 模板引擎的變量調節器（Modifier）語法看似簡單，卻藏著極易忽視的「空格陷阱」。本文還原一次真實調試過程，揭示 {$name | upper} 為何失效，而 {$name|upper} 卻正常的底層解析邏輯。

現場還原

{* 模板代碼 *}
{$name | upper}
{* 輸出結果：原始值，未轉大寫 *}

檢查項目：

• SmartY 版本正確（3.1.x）
• 插件目錄 plugins/modifier.upper.php 存在
• $smarty->loadPlugin('modifier_upper') 可手動加載
• 模板編譯緩存已清理
• 變量 $name 賦值正常

耗時 1 小時無果，絕望中刪除重寫：

{$name|upper}
{* 輸出：預期的大寫字符串 *}

根因：SmartY 模板詞法分析器的 Token 匹配規則

SmartY 編譯器在解析變量調節器時，採用無空格貪婪匹配策略：

// 簡化版編譯器邏輯 (SmartY_Compiler.class.php)
if (preg_match('/^\$\w+(\s*\|\s*\w+)*$/', $token)) {
    // 解析調節器鏈
} else {
    // 視為普通變量輸出，忽略後續內容
}

關鍵正則：\s*\|\s* 允許管道符前後有空格，但變量名與第一個管道符之間不能有空格。
即：{$var|modifier} ✅、{$var |modifier} ❌、{$var| modifier} ✅（管道後空格允許）。

為什麼設計成這樣？

• 避免與數學運算符衝突：{$a - $b} 減法 vs {$a|modifier} 調節器
• 變量名允許字母數字下劃線，管道符 | 作為明確分隔符
• 歷史兼容性：早期版本即如此，修改會破舊模板

完整語法規範速查

防範清單：模板調試黃金法則

1. 刪除重寫法：遇到不可解釋的語法失效，選中整行刪除，手動重輸入（清除隱形字符/全角空格/零寬空格）。
2. 編譯文件檢查法：查看 templates_c/ 下對應編譯後的 PHP 文件，確認生成代碼是否包含 smarty_modifier_upper() 調用。
3. 語法高亮依賴法：使用支持 SmartY 語法高亮的編輯器（PhpStorm + 插件、VS Code + Smarty extension），錯誤語法會顯示異常顏色。
4. 最小復現法：新建極簡模板 test.tpl 僅含問題語法，隔離環境驗證。

延伸：其他模板引擎的同類陷阱

• Twig：{{ var|upper }} 嚴格要求無空格，{{ var | upper }} 拋出語法錯誤（更友好）
• Blade：{{ strtoupper($var) }} 函數調用，無調節器概念
• Volt (Phalcon)：{{ var|upper }} 僅允許管道符前無空格

結論：模板語法對空格極其敏感，養成「變量名緊貼管道符」的肌肉記憶，將節省無數調試小時。

1. 上一篇文章： PHP 連接 MySQL localhost 失效解決方案：Unix Socket vs TCP 協議差異與配置修正
2. 下一篇文章： PHP 編譯安裝常見兩大錯誤：ldap 庫缺失與 PDO_MYSQL 編譯失敗完美修復

PHP 綜合知識

PHP 生成樹狀結構類：無限分類與層級展示

Tree 類設計 setNode($id, $parent

PHP 圖片上傳完整實現：類型驗證、大小限制、水印、縮略圖生成

PHP 圖片上傳功能完整實現：驗證、水印、縮略圖一站式解決

PHP 爬蟲實戰：利用 Simple HTML DOM 解析 LOL 玩家數據

需求：輸入大區與召喚師名稱，抓取多玩（現貓眼/OP.GG 等

PHP $_FILES 暫存檔案生命週期與回收機制實測：跨請求使用臨時檔的正確姿勢

上傳檔案預設存放於系統暫存目錄，檔名格式為 phpXXXXX