您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 綜合知識

ThinkPHP 模板 IF 標籤深度解析：條件判斷、運算子、最佳實踐

編輯：PHP 綜合知識

IF 標籤：模板邏輯的核心

ThinkPHP 模板引擎的 <if> 標籤提供強大的條件判斷能力，支援複雜邏輯組合、PHP 函數調用、變數屬性存取（點語法/對象語法），是模板中實現動態顯示的關鍵。但濫用會導致模板邏輯過重、難以維護，本文將系統梳理語法、運算子、進階用法與最佳實踐。

基本語法結構

<if condition="判斷條件">
    條件成立輸出內容
<elseif condition="另一條件" />
    另一條件成立輸出
<else />
    以上都不成立輸出
</if>

condition 屬性內為類 PHP 表達式，但禁止直接使用 > < 符號（會干擾 XML 解析），必須使用字母運算子。
<elseif> 和 <else> 為單標籤（以 /> 結尾）。
可無限嵌套，但建議不超過 3 層。

支援的比較運算子（必須使用）

邏輯組合運算子

AND / &&：邏輯與
OR / ||：邏輯或
XOR：邏輯異或
NOT / !：邏輯非
支援括號 () 改變優先級

範例：

<if condition="($user.role eq 'admin' OR $user.role eq 'editor') AND $user.status eq 1">
    顯示管理面板
<else />
    權限不足
</if>

進階特性：在 condition 中呼叫 PHP 函數

condition 內可直接使用 PHP 內建函數或自定義函數（需在模板函數白名單 TMPL_ALLOW_PHP_FUNCS 中註冊）：

<if condition="strtoupper($user['name']) neq 'THINKPHP'">
    非 ThinkPHP 用戶
<else />
    ThinkPHP 用戶
</if>

<if condition="in_array($item.id, $allowed_ids)">
    允許訪問
</if>

<if condition="strlen($content) gt 100">
    內容過長
</if>

變數存取語法：點語法 vs 對象語法

ThinkPHP 模板引擎會自動判斷變數是陣列還是對象，以下三種寫法等效：

<!-- 陣列 -->
<if condition="$user['name'] neq 'Guest'">...</if>

<!-- 對象屬性 -->
<if condition="$user:name neq 'Guest'">...</if>

<!-- 自動判斷（推薦，最簡潔）-->
<if condition="$user.name neq 'Guest'">...</if>

系統變數同樣支援：$Think.get.id、$Think.session.user_id、$Think.cookie.lang、$Think.server.REQUEST_URI。

函數修飾符鏈式調用

變數後可接 | 連續呼叫函數（類 Unix 管道）：

<if condition="$user:name|strlen gt 10">
    用戶名過長
</if>

<if condition="$article.title|strtolower|md5 eq $hash">
    標題哈希匹配
</if>

與 `<switch>`、比較標籤的選擇原則

官方建議優先級：
1. 比較標籤 (<eq>, <gt> 等) —— 語義最清晰、支援變數調節器、效能最好。
2. Switch 標籤 (<switch>) —— 多值匹配單一變數時最優雅。
3. IF 標籤 —— 僅在以上無法滿足（如複雜邏輯組合、函數調用、多變數比較）時使用。
4. 原生 PHP (<?php ... ?> 或 <php>...</php>) —— 最後手段。

常見錯誤與避坑指南

運算子	含義	PHP 對應	範例
`eq` / `equal`	等於	`==`	`condition="$status eq 1"`
`neq` / `notequal`	不等於	`!=`	`condition="$status neq 0"`
`gt`	大於	`>`	`condition="$age gt 18"`
`egt`	大於等於	`>=`	`condition="$score egt 60"`
`lt`	小於	`<`	`condition="$stock lt 10"`
`elt`	小於等於	`<=`	`condition="$num elt 100"`
`heq`	恆等於（型別也相同）	`===`	`condition="$type heq 'admin'"`
`nheq`	不恆等於	`!==`	`condition="$val nheq false"`

錯誤寫法	問題	正確寫法
`<if condition="$a > 5">`	`>` 被解析為標籤結束	`<if condition="$a gt 5">`
`<if condition="$a == $b">`	`==` 不支援	`<if condition="$a eq $b">`
`<if condition="isset($var)">`	未在白名單	用 `<present name="var">` 或配置 `TMPL_ALLOW_PHP_FUNCS`
`<if condition="$obj->method()">`	不支援方法呼叫	控制器預先計算好傳模板
過度嵌套 5+ 層 IF	模板邏輯過重，難維護	重構到控制器或使用 Switch/比較標籤

實戰範例：電商商品顯示邏輯

<div class="product-card">
    <h3>{$goods.name}</h3>
    
    <!-- 價格顯示 -->
    <if condition="$goods.promote_price gt 0">
        <span class="promote-price">¥{$goods.promote_price}</span>
        <del>¥{$goods.shop_price}</del>
    <else />
        <span class="normal-price">¥{$goods.shop_price}</span>
    </if>
    
    <!-- 庫存狀態 -->
    <switch name="goods.stock">
        <case value="0"><span class="out-of-stock">缺貨</span></case>
        <case value="1|2|3|4|5"><span class="low-stock">庫存緊張 (剩 {$goods.stock})</span></case>
        <default /><span class="in-stock">有貨</span>
    </switch>
    
    <!-- VIP 專屬 -->
    <if condition="$Think.session.user.vip_level egt 3 AND $goods.is_vip_exclusive">
        <span class="vip-tag">VIP 專享</span>
    </if>
</div>

效能優化建議

減少 condition 複雜度： 複雜判斷移至控制器，模板只判斷布林變數（$show_vip_tag）。
善用比較標籤： 簡單比較用 <eq>/<gt>，編譯後為簡單 if，比 <if> 快。
避免在循環中重複複雜判斷： 預先計算標記字段。
開啟模板緩存： 'TMPL_CACHE_ON' => true，編譯後為 PHP 檔案，運行時無解析開銷。

總結

ThinkPHP <if> 標籤功能強大，支援類 PHP 表達式、函數調用、多種變數語法、邏輯組合。但「能用 IF 不代表都該用 IF」——遵循「比較標籤 > Switch > IF > 原生 PHP」的選擇原則，將業務邏輯沉澱到控制器/服務層，模板專注於展示，才能構建清晰、可維護、高效能的視圖層。