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

PHP 模板引擎實現：基於標記替換生成靜態 HTML 的類設計

編輯：PHP 綜合知識

從字符串拼接到模板分離：一個輕量級 PHP 生成靜態 HTML 類的實現

早期 PHP 開發常將 HTML 以長字符串形式硬編碼在代碼中，維護極其困難。本文介紹一個基於「標記替換」思想的模板類 TCreateHTML，通過在模板文件中定義特殊標記，實現邏輯與視圖的初步分離。

核心設計思想

模板文件：純 HTML，嵌入特定格式標記
標記格式：啟動標記 ，結束標記 
替換邏輯：讀取模板行，識別標記區塊，用預設數據替換區塊內容

完整類實現代碼

<?php
// TCreateHTML.class.php
// 作者：sharetop | email: ycshowtop@21cn.com

// --- 輔助函數 ---
function isbegin($str) {
    return (bool)preg_match("/<!--##[a-zA-Z]+##-->/", $str);
}
function isfinish($str) {
    return (bool)preg_match("/<!--@@[a-zA-Z]+@@-->/", $str);
}
function getname($str) {
    $tmp = explode("##", $str);
    return $tmp[1] ?? '';
}

// --- 核心類 ---
class TCreateHTML {
    var $HTemplate;   // 模板文件路徑
    var $FileName;    // 輸出文件路徑
    var $ModiString = []; // 標記名 => 替換內容

    // 構造函數：指定模板文件
    function TCreateHTML($tmplate) {
        $this->HTemplate = $tmplate;
    }

    // 設置輸出文件名
    function SetHTML($filename) {
        $this->FileName = $filename;
    }

    // 註冊標記替換內容
    function EditableBlock($name, $replace) {
        $this->ModiString[$name] = $replace;
    }

    // 執行生成
    function WriteHtml() {
        $fc = file($this->HTemplate); // 按行讀取
        $fp = fopen($this->FileName, "w");
        $k = count($fc);
        $begin = false;
        $first = false;
        $tag = "";

        for ($i = 0; $i < $k; $i++) {
            // 遇到開始標記
            if (isbegin($fc[$i])) {
                fputs($fp, $fc[$i]); // 保留標記行
                $begin = true;
                $first = true;
                $tag = getname($fc[$i]);
                continue;
            }
            // 遇到結束標記
            if (isfinish($fc[$i])) {
                fputs($fp, $fc[$i]);
                $begin = false;
                $first = false;
                $tag = "";
                continue;
            }
            // 標記區塊內：第一行替換，其餘清空
            if ($begin == true) {
                if ($first == true) {
                    $fc[$i] = $this->ModiString[$tag] . " ";
                    $first = false;
                } else {
                    $fc[$i] = "";
                }
            }
            fputs($fp, $fc[$i]);
        }
        fclose($fp);
    }
}
?>

使用示例

模板文件 template.htm：

<html>
<head><title><!--##title##--></title></head>
<body>
<h1><!--##title##--><!--@@title@@--></h1>
<div><!--##content##--><!--@@content@@--></div>
</body>
</html>

PHP 腳本：

<?php
require_once 'TCreateHTML.class.php';

$html = new TCreateHTML('template.htm');
$html->SetHTML('output.html');
$html->EditableBlock('title', '我的博客標題');
$html->EditableBlock('content', '<p>這是動態生成的內容...</p>');
$html->WriteHtml();

echo "靜態頁面已生成：output.html";
?>

優缺點分析

優點	缺點
零依賴，純 PHP 實現	僅支持簡單變量替換，無邏輯控制（循環、條件）
模板為純 HTML，設計師友好	標記語法較繁瑣，需成對編寫啟動/結束標記
理解成本極低，適合小項目	無緩存機制，高頻生成性能一般
輸出靜態文件，減輕服務器壓力	異常處理缺失（文件不存在、權限不足等）