PHP静态化首选ob_start()+file_put_contents()，需顶部调用、绝对路径、检查可写；cURL适合依赖服务器环境的页面；Sculpin仅适用于Markdown文档站，不推荐替代动态逻辑。
PHP本身没有内置的静态网站生成器，但你可以用它实现轻量级静态化——关键不是找“PHP版Hugo”，而是搞清你要解决什么问题：是批量生成文章页？缓存高频访问页？还是彻底替代动态渲染？答案不同，工具和写法完全不同。
ob_start() + file_put_contents() 是最直接的静态化路径
这是 PHP 原生能最快落地的方式，适合单页或少量页面的固化。它不依赖外部工具，但必须严格控制输出时机。
- 必须在脚本最顶部调用
ob_start()，任何前置空格、BOM、echo或print都会导致缓冲失败 -
ob_get_contents()只读取当前缓冲区快照，不清理；而ob_get_clean()会读取+清空，更适合生成后立即输出的场景 - 写入目标路径建议用绝对路径，例如
/var/www/html/static/about.html，避免 CLI 运行时相对路径解析为/root/下 - 执行前检查目录可写：
is_writable(dirname($filename))，否则file_put_contents()会静默失败或报failed to open stream: Permission denied
示例片段：
ob_start();
include 'templates/article.php'; // 里面用 $id = 123; echo "<h1>Article {$id}</h1>";
$html = ob_get_clean();
if (false === file_put_contents('/var/www/html/static/article_123.html', $html)) {
error_log('Static write failed for article_123');
}
cURL 拉取真实 HTTP 响应更贴近线上行为
当你页面严重依赖 $_SERVER、重写规则（如 Apache 的 .htaccess）、或登录态校验时，直接 include 模板会丢失上下文。cURL 方式模拟一次真实请求，拿到的是浏览器看到的最终 HTML。
立即学习“PHP免费学习笔记（深入）”；
- 务必设置
CURLOPT_RETURNTRANSFER => true，否则响应直接输出到屏幕 - 检查
curl_getinfo($ch, CURLINFO_HTTP_CODE)是否为 200，避免把 404 或 500 页面也存成静态文件 - 本地请求用
http://localhost/，不要用127.0.0.1（某些 hosts 配置下可能绕过 vhost） - 如果目标页含 CSRF token 或时间敏感内容（如“当前在线：32人”），这种快照方式会让静态页失效——得提前注入数据，而非靠 URL 触发
别把 Sculpin 当“PHP 版 Hugo”来用
Sculpin 是一个真实存在的 PHP SSG，但它定位明确：面向 Markdown 博客/文档站，不是通用动态页静态化工具。它的构建流程和 Hugo/Jekyll 类似，但生态小、维护弱，2026 年已无活跃更新。
- 它要求你组织内容为
source/_posts/+ YAML Front Matter，不适合从现有 PHP 业务逻辑中抽离 -
./vendor/bin/sculpin generate --env=prod输出到output_prod/，不是直接覆盖 Web 根目录，需额外同步步骤 - 如果你已有大量
.php页面且含数据库查询，强行迁移到 Sculpin 意味着重写所有数据获取逻辑为 Twig 变量注入，成本远高于用ob_start()封装
静态化不是一劳永逸，动态内容得提前“冻结”
生成的 HTML 是快照，里面的时间、计数器、用户昵称、数据库结果全被固化。你以为的“静态化”，可能只是把 bug 也一起存下来了。
- 不要在模板里写
<span>= date('Y-m-d') ?></span>—— 静态页发布后这个日期就永远停在生成那天 - 依赖用户登录态的页面（如“欢迎，张三”）无法直接静态化，要么改用前端 JS 动态补全，要么在生成阶段传入预计算好的用户名
- 搜索、评论这类交互功能，静态页天然不支持，得靠第三方服务（如 Algolia、Utterances）或留白由 JS 加载
真正容易被忽略的点是：静态文件的生命周期管理。没人删旧文件，article_123.html 改成 article_124.html 后，老链接依然存在，404 率会上升——你得配套加清理逻辑或用符号链接兜底。
