ThinkPHP 模板循環標籤用法完全指南

核心規則

模板循環中變數不需加 $ 符號，直接使用名稱。

三大循環標籤對比

1. <for> 標籤：數值範圍循環

<table border='1' width='500'>
    <for start='0' end='10' name='j' step='2' comparison='lt'>
        <tr><td>{$j}</td><td>abc</td></tr>
    </for>
</table>

• start：起始值
• end：結束值
• step：步長
• comparison：lt 正序遞增、gt 倒序遞減
• name：循環變數名

2. <volist> 標籤：陣列/物件循環（最常用）

<volist name='list' id='v'>
    {$v.username}<br/>
</volist>

• name：資料來源變數（控制器 assign 的陣列）
• id：當前項目變數名
• offset、length：分頁截取
• key：鍵名變數（可選）
• mod：取模數，用於斑馬紋等

3. <foreach> 標籤：簡化版陣列循環

<foreach name='list' item='v' key='k'>
    {$k}-------{$v}<br/>
</foreach>

• 功能與 volist 類似，語法更接近 PHP 原生 foreach
• item：值變數，key：鍵變數

進階技巧

效能建議

• 大量資料（>1000筆）建議控制器分頁後再傳遞，避免模板渲染過慢
• 關閉模板編譯快取開發模式，上線開啟