用PHP快速生成前端静态页面的实用技巧
年卡会员写 PHP 的人，多少都干过“体力活”：比如把一大段 JSON 或者数据库记录，手动拼成一堆结构类似的 HTML 文件。改一次数据，就得复制粘贴一次，改到怀疑人生。其实，PHP 本身就是一个非常趁手的静态页面生成器，只要换个思路，就能把这种重复劳动变成一行命令的事。
从“动态渲染”到“静态输出”的思路转变
很多人的第一反应是：PHP 不就是用来做动态网站的吗？怎么反而生成静态页？
道理很简单：动态页面是“请求时计算”，静态页面是“构建时计算”。如果你的内容不经常变化（比如文档、活动落地页、产品介绍），完全可以让 PHP 在部署或更新时跑一遍脚本，把渲染好的 HTML 文件直接写到磁盘上。前端直接访问这些纯静态文件，速度飞快，还省去了 PHP 解析和数据库查询的开销。
举个最朴素的例子。你有一个模板文件 `template.php`，里面是混杂着 PHP 变量的 HTML 结构。以前你可能通过 URL 参数去访问它，现在只需要写一个简单的构建脚本：
<?php
$pageTitle = '2024 年度产品介绍';
$content = '<p>这是正文内容……</p>';
ob_start();
include 'template.php';
$html = ob_get_clean();
file_put_contents('output/product-intro.html', $html);
核心就是 `ob_start()` 配合 `file_get_contents`，它能把 PHP 执行后的输出“捕获”到内存里，而不是直接发给浏览器，然后你再把这段字符串写到文件里。这基本就是所有静态化工具的原理。
批量生成：循环加数据源，告别手动复制
单个页面没什么感觉，批量生成才是生产力。你可以定义一个数组，里面放所有页面的元信息，然后用 `foreach` 循环生成整个目录结构。
$pages = [
['slug' => 'about', 'title' => '关于我们', 'content' => '...'],
['slug' => 'contact', 'title' => '联系我们', 'content' => '...'],
['slug' => 'faq', 'title' => '常见问题', 'content' => '...'],
];
foreach ($pages as $page) {
// 提取变量到当前符号表，模板里直接使用 $slug、$title 等
extract($page);
ob_start();
include 'template.php';
$html = ob_get_clean();
// 自动创建目录，防止路径不存在报错
if (!is_dir('output')) {
mkdir('output', 0777, true);
}
file_put_contents("output/{$slug}.html", $html);
}
配合多级目录或分类参数，你可以很容易地生成 `blog/2024/01/xxx.html` 这样的结构。关键是：模板仍然用 PHP 写，循环体负责把数据填进去，数据可以是手写的数组，也可以是从数据库或 Markdown 文件中读取的内容。这本质上就是一种轻量级的“数据 + 模板 = 静态文件”的静态站点生成器。
复用公共部分：别再把头尾复制得到处都是
很多新手会犯一个错误：为了生成静态页，把导航栏和页脚的 HTML 直接黏进每个模板文件，结果改一次导航要全局替换。
更好的做法是让模板自己拼装。你可以把页头和页脚写成两个独立文件，在主模板中通过 `include` 引入。更进一步，可以建立一个布局文件 `layout.php`，用变量控制主区域的内容。
// layout.php
<!DOCTYPE html>
<html>
<head><title><?= $pageTitle ?></title></head>
<body>
<?php include 'partials/header.php'; ?>
<?= $mainContent ?>
<?php include 'partials/footer.php'; ?>
</body>
</html>
这时，生成脚本里的逻辑就变成：先渲染 `content.php` 获得内容字符串，再把它当变量赋给布局文件。这其实就是“Twig”或“Blade”模板引擎的底层逻辑，只不过我们用原生 PHP 手动实现了，而且没有额外依赖，部署时也无需麻烦的编译步骤。
不过，如果项目模板比较复杂，还是建议直接使用 `Twig` 这类成熟引擎。Twig 支持模板继承和区块概念，比手写 `include` 嵌套更清晰。用 PHP 生成静态页面，并不代表你要排斥第三方库，反而可以利用 Composer 把它们装进来，配合一个简单的构建脚本调用。
把静态化嵌入工作流
生成静态页不是一次性的动作。内容一旦更新，需要重新执行构建命令。建议做一个名为 `build.php` 的脚本，放在项目根目录，在部署前或修改内容后执行 `php build.php`。
你还可以在这个构建脚本里额外做一些事：
- 检查目标目录是否有残留旧文件，自动清理。
- 生成一个 `sitemap.xml`，方便 SEO。
- 计算每个页面的 MD5 值，只有内容变更时才覆盖文件，减少不必要的磁盘写入。
- 把生成的 HTML 文件压缩，去掉多余空格和注释。
最后想说的是：静态化不等于放弃动态能力。很多团队在用“静态页面骨架 + 动态数据接口”的混合模式，利用 PHP 生成静态 UI，再通过 JS 请求后端接口填充用户相关数据。这种方式既保留了静态页的加载速度，又没有丢掉个性化内容的灵活性。
用 PHP 去生成静态页，与其说是一种技术方案，不如说是一种工程思维的转变。当你意识到 PHP 不仅能“处理请求”，还能“生产文件”时，原本繁琐的重复劳动，都变成了可以自动化控制的小脚本。下次再有那种结构类似的页面要批量做时，别急着复制粘贴，先写个十行的 PHP 脚本，一劳永逸。