Smarty 提供豐富的內建函數,讓模板具備流程控制能力,減少 PHP 端邏輯。本文重點講解 foreach 遍歷各類陣列、if/elseif/else 條件判斷的語法與最佳實踐。
foreach 遍歷陣列語法:{foreach from=$array item=$item key=$key}...{/foreach}
from(必填)指定陣列,item(必填)當前元素變量名,key(可選)當前鍵名變量名。
{* 索引陣列 *}
{foreach from=$arr item=temp}
{$temp}
{/foreach}
{* 關聯陣列 *}
{foreach from=$arr2 item=temp key=k}
{$k} = {$temp}
{/foreach}
{* 二維索引陣列 *}
{foreach from=$arr3 item=row key=k}
{foreach from=$row item=val}
{$val}
{/foreach}
{/foreach}
{* 二維關聯陣列(外層無需 key) *}
{foreach from=$arr4 item=row}
{foreach from=$row item=val key=k}
{$k} = {$val}
{/foreach}
{/foreach}
{* 二維關聯陣列帶外層 key *}
{foreach from=$arr5 item=row key=k}
{$k}:
{foreach from=$row item=val key=k2}
{$k2} = {$val}
{/foreach}
{/foreach}
if/else{if $age > 10}
年齡大於 10,年齡為:{$age}
{else}
年齡小於等於 10,年齡為:{$age}
{/if}
if/elseif/else 多條件分支假設數據源:
$res4 = array(
array('id'=>'001','age'=>'4'),
array('id'=>'002','age'=>'16'),
array('id'=>'003','age'=>'20'),
array('id'=>'004','age'=>'80')
);
模板:
{foreach from=$arr4 item=temp}
{if $temp.age < 5}
{$temp.id},你是小孩
{elseif $temp.age >= 5 and $temp.age <= 18}
{$temp.id},你是年輕人
{elseif $temp.age > 18 and $temp.age <= 50}
{$temp.id},你是成年人
{else}
{$temp.id},年齡比較大了
{/if}
{/foreach}
| 函數 | 用途 |
|---|---|
foreach | 遍歷陣列/物件,支援巢狀、key/item 重命名 |
foreachelse | 在 foreach 內部,陣列為空時執行 |
if/elseif/else | 條件判斷,支援 eq/neq/gt/lt/gte/lte/mod/div/is [not] div/even/odd 等運算符 |
include | 引入子模板 |
assign | 模板中賦值變量 |
capture | 捕獲模板輸出到變量 |
section | 類似 for 迴圈,支援 step/max/start |
strip | 移除輸出中的多餘空白 |
foreachelse 優雅處理空陣列情況。===、!== 等嚴格比較(Smarty 3+ 支援)。@index、@iteration、@first、@last 等 foreach 屬性控制輸出格式。熟練掌握這些內建函數,能讓 Smarty 模板既保持簡潔,又能應對豐富的展示邏輯。