Destoon 二次開發模板與調用語法完整匯總

一、模板存放與調用規則

模板位於 template/ 目錄，每個子目錄代表一套模板（如 template/default/）。模板檔案以 .htm 為副檔名，可直接置於模板目錄或子目錄（如 template/default/member/index.htm）。

PHP 中調用模板

// 調用當前模板目錄下的 header.htm
<?php include template('header'); ?>

// 調用 member 子目錄下的 header.htm
<?php include template('header', 'member'); ?>

若當前模板為 default，上述分別解析為 template/default/header.htm 與 template/default/member/header.htm。

模板別名配置檔：these.name.php，可在後台「模板管理」修改。模板解析後的快取存放於 cache/tpl/，副檔名 .tpl.php。

二、模板語法詳解

1. 包含模板

{template 'header'}           // 當前目錄
{template 'header', 'member'}  // 指定子目錄

2. 變數與常量輸出

{$destoon}     // 變數 → <?php echo $destoon; ?>
{DESTOON}      // 常量 → <?php echo DESTOON; ?>
{$destoon['index']} // 陣列標準寫法
{$destoon[index]}   // 簡寫，解析時自動加引號

3. 函數調用

{func_name($par1, $par2)}  // → <?php func_name($par1, $par2); ?>

4. PHP 表達式

{php expression}  // → <?php expression ?>

5. 條件判斷

{if $a=='b'} do A {/if}
{if $a=='b'} do A {else} do B {/if}
{if $a=='b'} do A {elseif $b=='c'} do C {else} do B {/if}

6. 循環輸出

{loop $var $v} ... {/loop}           // 僅值
{loop $var $k $v} ... {/loop}         // 鍵值對

三、特殊用法

1. HTML 註釋包裹變數：<!--{$destoon}--> 仍會被解析輸出，且可自動過濾此類註釋。
2. 直接撰寫 PHP 代碼：模板中可直接編寫原生 PHP，與 Destoon 模板語法完全兼容，靈活度極高。