PHP 生成静态页面技术详解：模板解析、文件操作与分页实现

动态页 vs 静态页

模板机制原理

模板 = 含占位符的 HTML 文件。PHP 读取模板，用业务数据替换占位符，写入目标静态文件。

简单模板示例 (temp.html)

<html>
<head><title>{title}</title></head>
<body>
    <h1>{title}</h1>
    <div>{content}</div>
</body>
</html>

PHP 解析并生成静态文件

<?php
$title   = 'PHP 静态页生成演示';
$content = '这是通过模板替换生成的静态页面内容。';

// 1. 读取模板
$tpl = file_get_contents('temp.html');

// 2. 替换占位符
$html = str_replace(['{title}', '{content}'], [$title, $content], $tpl);

// 3. 写入目标文件
$targetFile = 'article/2024/01/01/demo.html';
$dir = dirname($targetFile);
if (!is_dir($dir)) mkdir($dir, 0755, true);

$fp = fopen($targetFile, 'w');
if (!$fp) die("无法创建文件: $targetFile");
fwrite($fp, $html);
fclose($fp);

echo "静态页生成成功: $targetFile";
?>

实战进阶：文章列表与分页生成

场景

• 文章表 articles，字段：id, title, slug, channel_id, created_at
• 列表页模板含 {article_list} 占位符
• 每页 20 条，生成 index.html, index_2.html ...

完整生成脚本

<?php
// 配置
$pageSize = 20;
$channelId = 1;
$tplFile = 'list_tpl.html';
$outDir = 'news/channel_1/';

// 1. 读取模板
$tpl = file_get_contents($tplFile);

// 2. 查询总数
$pdo = new PDO('mysql:host=localhost;dbname=cms', 'user', 'pass');
$total = $pdo->query("SELECT COUNT(*) FROM articles WHERE channel_id=$channelId")->fetchColumn();
$totalPages = ceil($total / $pageSize);

// 3. 循环生成每页
for ($page = 1; $page <= $totalPages; $page++) {
    $offset = ($page - 1) * $pageSize;
    $stmt = $pdo->prepare("SELECT title, slug FROM articles WHERE channel_id=? ORDER BY created_at DESC LIMIT ?, ?");
    $stmt->execute([$channelId, $offset, $pageSize]);
    $rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

    // 4. 组装列表 HTML
    $listHtml = '';
    foreach ($rows as $row) {
        $listHtml .= "<li><a href='/article/{$row['slug']}.html'>{$row['title']}</a></li>\n";
    }

    // 5. 替换模板
    $pageHtml = str_replace('{article_list}', $listHtml, $tpl);
    // 可再替换分页导航 {pager} 等

    // 6. 确定输出文件名
    $fileName = ($page === 1) ? 'index.html' : "index_$page.html";
    $target = $outDir . $fileName;

    // 7. 写入文件 (存在则覆盖)
    if (file_exists($target)) unlink($target);
    $fp = fopen($target, 'w');
    fwrite($fp, $pageHtml);
    fclose($fp);
    echo "Generated: $target\n";
}

echo "分页静态页生成完成，共 $totalPages 页。";
?>

关键技术点总结

现代化替代：静态站点生成器 (SSG)

• Jekyll / Hugo / Next.js / Nuxt / Astro：构建时生成全站静态文件，原生支持 Markdown、组件化、增量构建、CDN 部署。
• PHP 生态：Sculpin、PhpStatic 基于 Twig/Markdown 生成静态站。

若项目以内容发布为主、交互少，SSG 架构比动态 PHP + 定时生成静态页更简洁、性能更强、维护成本更低。