PHP静态网站生成器教程-php教程-PHP中文网

php静态化首选ob_start()+file_put_contents()，需顶部调用、绝对路径、检查可写；curl适合依赖服务器环境的页面；sculpin仅适用于markdown文档站，不推荐替代动态逻辑。

php静态网站生成器教程

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。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

务必设置 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() 封装