PHP 靜態頁面生成類別：模板替換、SHTML 輸出

PHP 簡易靜態頁生成類別：模板標籤替換輸出 HTML

輕量級靜態頁生成類別 `Shtml`，將資料陣列對應替換模板中的 `` 標籤，生成靜態 HTML 檔案，適合簡單的內容發佈系統。

類別程式碼

<?php
class Shtml {
    public $DataSource = []; // 資料來源陣列 [鍵 => 值]
    public $Templet = '';    // 模板字串
    public $FileName = '';   // 輸出檔案路徑

    // 綁定資料
    public function BindData(array $arr) {
        $this->DataSource = $arr;
    }

    // 設定模板
    public function setTemplate($template) {
        $this->Templet = $template;
    }

    // 設定輸出檔案
    public function setFileName($filename) {
        $this->FileName = $filename;
    }

    // 生成靜態頁
    public function Create() {
        if (empty($this->Templet)) {
            throw new Exception('模板未設定');
        }
        if (empty($this->FileName)) {
            throw new Exception('輸出檔案未設定');
        }

        $tmp = $this->Templet;

        // 替換所有標籤
        foreach ($this->DataSource as $key => $value) {
            $tag = '<FIELD_' . $key . '>';
            $tmp = str_replace($tag, $value, $tmp);
        }

        // 確保目錄存在
        $dir = dirname($this->FileName);
        if (!is_dir($dir)) {
            mkdir($dir, 0755, true);
        }

        // 寫入檔案
        $result = file_put_contents($this->FileName, $tmp);
        if ($result === false) {
            throw new Exception("寫入檔案失敗: {$this->FileName}");
        }
        return $result; // 回傳寫入位元組數
    }
}
?>

使用範例

<?php
require 'Shtml.php';

$data = [
    'title'   => '最新文章標題',
    'content' => '<p>這是文章內容，支援 HTML 標籤。</p>',
    'author'  => '張三',
    'date'    => date('Y-m-d H:i:s')
];

$template = '
<!DOCTYPE html>
<html>
<head>
    <title><FIELD_title></title>
</head>
<body>
    <h1><FIELD_title></h1>
    <div class="meta">作者: <FIELD_author> | 日期: <FIELD_date></div>
    <div class="content"><FIELD_content></div>
</body>
</html>
';

$generator = new Shtml();
$generator->BindData($data);
$generator->setTemplate($template);
$generator->setFileName('output/article_' . time() . '.html');

try {
    $bytes = $generator->Create();
    echo "靜態頁生成成功: {$generator->FileName} ({$bytes} bytes)";
} catch (Exception $e) {
    echo "錯誤: " . $e->getMessage();
}
?>

進階擴展：支援區塊迴圈、條件判斷

// 擴展版：支援  ...  迴圈
class AdvancedShtml extends Shtml {
    public function Create() {
        $tmp = $this->Templet;

        // 1. 處理迴圈區塊
        if (preg_match_all('/<!-- BEGIN:(\w+) -->(.*?)<!-- END:\\1 -->/s', $tmp, $matches)) {
            foreach ($matches[1] as $i => $blockName) {
                $blockContent = $matches[2][$i];
                $fullBlock = $matches[0][$i];

                // 資料必須是陣列的陣列
                if (isset($this->DataSource[$blockName]) && is_array($this->DataSource[$blockName])) {
                    $rendered = '';
                    foreach ($this->DataSource[$blockName] as $item) {
                        $itemHtml = $blockContent;
                        foreach ($item as $k => $v) {
                            $itemHtml = str_replace('<FIELD_' . $k . '>', $v, $itemHtml);
                        }
                        $rendered .= $itemHtml;
                    }
                    $tmp = str_replace($fullBlock, $rendered, $tmp);
                } else {
                    $tmp = str_replace($fullBlock, '', $tmp); // 無資料則移除區塊
                }
            }
        }

        // 2. 處理條件區塊  ... 
        $tmp = preg_replace_callback('/<!-- IF:(\w+) -->(.*?)<!-- ENDIF:\\1 -->/s', function($m) {
            return !empty($this->DataSource[$m[1]]) ? $m[2] : '';
        }, $tmp);

        // 3. 一般欄位替換
        foreach ($this->DataSource as $key => $value) {
            if (!is_array($value)) { // 跳過迴圈資料
                $tmp = str_replace('<FIELD_' . $key . '>', $value, $tmp);
            }
        }

        // 寫入檔案...
        return file_put_contents($this->FileName, $tmp);
    }
}
?>

優缺點分析

現代替代方案 (強烈推薦)

• Twig：功能最完整、安全 (自動逃脫)、快取、繼承、區塊、過濾器、Symfony/Laravel 皆整合
• Blade (Laravel) / Volt (Phalcon)：框架專用、語法優雅
• Smarty：老牌、功能豐富、但語法較舊
• Plates：原生 PHP 模板、無編譯、輕量
• Latte：安全、快、語法類 Twig、Nette 框架預設

本類別適合極簡專案、靜態站點生成器、舊系統維護、學習模板引擎原理。新專案請直接使用成熟模板引擎。