PHP 动态生成静态 HTML 文件类实现方法

温以宁

发布时间：2026-10-14 | 6人浏览过

原创

通过自定义 PHP 类封装模板解析与文件写入逻辑，利用占位符替换技术实现内容的动态生成与静态保存，帮助开发者快速构建简易的伪静态化功能。

实现原理与代码结构

生成静态页面的核心思路是将“数据”与“展示”分离。我们定义一个 Shtml 类，包含三个主要属性：数据源（DataSource）、模板字符串（Templet）以及目标文件名（FileName）。该类主要提供两个公共方法：BindData 用于注入数据，Create 用于执行渲染并输出文件。

<?php
class Shtml {
    var $DataSource;     // 关联数组，存储替换值
    var $Templet;        // 字符串，模板内容
    var $FileName;       // 字符串，生成的目标文件路径

    // 绑定数据源
    function BindData($arr) {
        $this->DataSource = $arr;
    }

    function Create() {
        // 1. 获取模板内容
        $tmp = $this->Templet;
        
        // 2. 遍历数据源进行替换
        foreach($this->DataSource as $key => $value) {
            // 将模板中 <FIELD_字段名> 替换为实际值
            $tmp = str_replace('<FIELD_' . $key . '>', $value, $tmp);
        }
        
        // 3. 生成文件
        $fp = fopen($this->FileName, 'w');
        if ($fp) {
            fwrite($fp, $tmp);
            fclose($fp);
        } else {
            // 处理写入失败情况
            error_log("Failed to write file: " . $this->FileName);
        }
    }
}

具体使用步骤

第 1 步：准备数据源数组

首先构建一个关联数组，键名需对应模板中的字段标识，值为待替换的实际内容。

$arr = array();
$arr["title"] = "这里是标题";
$arr["content"] = "这里是正文内容";

第 2 步：实例化类并配置参数

创建 Shtml 对象，设置模板内容和最终保存的文件名（通常以 .htm 或 .html 结尾）。

$obj = new Shtml;
$obj->FileName = "output_article.htm";
// 模板中使用 <FIELD_> 格式作为占位符
$obj->Templet = "<!DOCTYPE html>
<html>
<head><title><FIELD_title></title></head>
<body>
  <h1><FIELD_title></h1>
  <p><FIELD_content></p>
</body>
</html>";

// 绑定数据
$obj->BindData($arr);

第 3 步：执行生成并验证结果

调用 Create() 方法。成功后，脚本会在当前目录生成指定的 HTML 文件，浏览器打开该文件即可看到渲染后的静态页面。

$obj->Create();
echo "静态页面生成成功！";

注意事项与优化建议

上述基础示例展示了核心逻辑，但在实际生产环境中，建议注意以下几点：

安全性过滤：若文章内容包含用户输入，在写入模板前应使用 htmlspecialchars 等函数过滤特殊字符，防止 XSS 攻击或破坏 HTML 结构。
文件权限：确保 PHP 运行用户对输出目录具有写入权限。
现代替代方案：对于复杂的站点，建议使用成熟的模板引擎（如 Smarty、Twig 或 Laravel Blade），它们支持缓存机制、嵌套布局和更强大的控制语法，比简单的字符串替换更健壮。