DedeCMS {dede:php} 標籤完整使用指南與實戰範例

前言

DedeCMS（織夢系統）提供 {dede:php} 標籤允許在模板中直接執行 PHP 代碼，為二次開發提供極大靈活性。本文詳細介紹標籤語法、變數存取、SQL 查詢整合、條件判斷等實戰技巧，並提供安全使用建議。

基本語法

{dede:php}
// PHP 代碼
{/dede:php}

等同於標準 PHP：

<?php
// PHP 代碼
?>

基礎範例

簡單運算輸出

{dede:php}
$numA = 1;
$numB = 2;
echo $numA + $numB; // 輸出: 3
{/dede:php}

條件判斷

{dede:php}
$score = 85;

if ($score >= 90) {
    echo "優秀";
} elseif ($score >= 80) {
    echo "良好";
} elseif ($score >= 60) {
    echo "及格";
} else {
    echo "不及格";
}
{/dede:php}

迴圈輸出

{dede:php}
$fruits = ['蘋果', '香蕉', '橘子', '葡萄'];

echo "
";
foreach ($fruits as $fruit) {
    echo "
$fruit
";
}
echo "
";
{/dede:php}

進階應用：DedeCMS 系統變數與資料庫操作

存取模板變數

{dede:php}
// 獲取當前文檔 ID
$aid = $refObj->Fields['id'];

// 獲取當前欄目 ID
$typeid = $refObj->Fields['typeid'];

// 獲取全局配置
$cfg_webname = $GLOBALS['cfg_webname'];
$cfg_basehost = $GLOBALS['cfg_basehost'];

echo "文章ID: $aid, 欄目ID: $typeid, 網站名: $cfg_webname";
{/dede:php}

SQL 查詢整合（核心實戰技巧）

{dede:php}
// 獲取 DedeCMS 資料庫操作物件
$dsql = $refObj->dsql;

// 單條查詢
$row = $dsql->GetOne("SELECT id, typename FROM dede_arctype WHERE id=2");
if ($row) {
    echo "欄目名稱: {$row['typename']}";
}

// 多條查詢
$dsql->SetQuery("SELECT id, title, arcurl FROM dede_archives WHERE typeid=2 ORDER BY pubdate DESC LIMIT 5");
$dsql->Execute();

echo "
";
while ($row = $dsql->GetArray()) {
    echo "
{$row['title']}
";
}
echo "
";
{/dede:php}

結合標籤巢狀使用

{dede:php}
global $dsql;
$typeid = $refObj->Fields['typeid'];

// 獲取當前欄目下的子欄目
$dsql->SetQuery("SELECT id, typename, typedir FROM dede_arctype WHERE reid=$typeid AND ishidden=0");
$dsql->Execute();

echo "
";
while ($row = $dsql->GetArray()) {
    // 使用 runphp 處理連結
    $typelink = $row['typedir'];
    $typelink = str_replace('{cmspath}', $GLOBALS['cfg_cmspath'], $typelink);
    $typelink = str_replace('{typedir}', $row['typedir'], $typelink);
    
    echo "{$row['typename']} ";
}
echo "
";
{/dede:php}

[field:global runphp='yes'] 內聯 PHP 標籤

在列表/內容模板字段中直接執行 PHP，適合簡單邏輯：

[field:global runphp='yes' name=autoindex]
$a = "<span class='num active'>";
$b = "</span>";
$c = "<span class='num'>";
if (@me > 3) @me = $c . @me . $b;
else @me = $a . @me . $b;
[/field:global]

關鍵變數：

• @me：當前字段值（輸入/輸出）
• name=autoindex：使用自增索引（1,2,3...）
• name=typeid：使用當前欄目 ID

實戰綜合範例：熱門文章側邊欄

{dede:php}
global $dsql, $cfg_cmspath;

// 獲取點擊數最高的 10 篇文章
$sql = "SELECT a.id, a.title, a.arcurl, a.litpic, a.description, a.click 
        FROM dede_archives a 
        WHERE a.arcrank > -1 
        ORDER BY a.click DESC 
        LIMIT 10";

$dsql->SetQuery($sql);
$dsql->Execute();

$html = "
熱門閱讀
";

while ($row = $dsql->GetArray()) {
    $title = cn_substr($row['title'], 40); // 截取標題
    $desc = cn_substr($row['description'], 80);
    $img = $row['litpic'] ? $row['litpic'] : $cfg_cmspath . '/images/defaultpic.gif';
    
    $html .= "<li>
        <a href='{$row['arcurl']}' title='{$row['title']}'>
            <img src='$img' alt='{$row['title']}' width='60' height='45'>
            <span class='title'>$title</span>
        </a>
        <p class='desc'>$desc</p>
        <span class='click'>閱讀: {$row['click']}</span>
    </li>";
}

$html .= "</ul></div>";

echo $html;
{/dede:php}

安全性警示與最佳實踐

⚠️ 風險提示

• 代碼注入風險：模板文件若被惡意修改，可執行任意 PHP 代碼
• 效能影響：模板中大量 PHP 邏輯降低渲染速度
• 維護困難：業務邏輯分散在模板中，難以版本控制與重構
• 安全審計盲區：靜態分析工具難以掃描模板內 PHP 代碼

<?php
// include/taglib/hotarticles.lib.php
if (!defined('DEDEINC')) exit();

function lib_hotarticles(&$ctag, &$refObj) {
    global $dsql, $cfg_cmspath;
    
    // 屬性解析
    $attlist = "limit|10,titlelen|40,desclen|80";
    FillAttsDefault($ctag->CAttribute->Items, $attlist);
    extract($ctag->CAttribute->Items, EXTR_SKIP);
    
    $sql = "SELECT id, title, arcurl, litpic, description, click 
            FROM dede_archives 
            WHERE arcrank > -1 
            ORDER BY click DESC 
            LIMIT $limit";
    
    $dsql->SetQuery($sql);
    $dsql->Execute();
    
    $html = "
";
    while ($row = $dsql->GetArray()) {
        $title = cn_substr($row['title'], $titlelen);
        $desc = cn_substr($row['description'], $desclen);
        $img = $row['litpic'] ? $row['litpic'] : $cfg_cmspath . '/images/defaultpic.gif';
        
        $html .= "
$title
";
    }
    $html .= "
";
    
    return $html;
}
?>