PHP静态化需用ob_start()捕获模板输出，file_put_contents()写入HTML；变量与循环须提前执行并固化为真实HTML；路径、URL、编码、SEO等细节需严格匹配上线环境。
PHP模板如何不依赖运行环境直接生成HTML文件
不能靠浏览器访问PHP页面再另存为HTML——那样拿不到动态渲染后的内容，也漏掉PHP逻辑生成的结构。必须让PHP脚本在命令行或服务端主动执行、捕获输出、写入磁盘。
核心是用 ob_start() + ob_get_clean() 捕获输出缓冲，再用 file_put_contents() 写成 .html 文件：
ob_start();
include 'post_template.php'; // 里面含 echo、循环、$title 等变量
$html = ob_get_clean();
file_put_contents('output/article-123.html', $html);
- 确保
post_template.php不含header()或重定向逻辑，否则会报“headers already sent” - 所有路径（如
include、图片链接、CSS引用）要转为相对静态路径或绝对URL，避免本地file://加载失败 - 如果原PHP依赖数据库，得提前查好数据并传入模板变量，不能在静态生成时调用
mysqli_connect()
怎么处理PHP中的动态变量和循环（比如文章列表）
静态化不是“复制粘贴PHP代码”，而是把变量值固化、把循环展开成真实HTML片段。例如一个文章列表页，不能留着 foreach ($posts as $p)，而要让它真正跑一遍，输出每篇的 <article>...</article>。
推荐做法：把数据准备和模板渲染拆开：
立即学习“PHP免费学习笔记（深入）”；
$posts = [
['slug' => 'hello-world', 'title' => '欢迎', 'date' => '2024-03-01'],
['slug' => 'php-static', 'title' => 'PHP转静态', 'date' => '2024-03-05']
];
// 遍历生成每篇文章HTML
foreach ($posts as $post) {
ob_start();
include 'single.php'; // 在里面用 $post['title'] 等
file_put_contents("output/{$post['slug']}.html", ob_get_clean());
}
// 再生成首页
ob_start();
include 'index.php';
file_put_contents('output/index.html', ob_get_clean());
- 不要在模板里写
require '../config.php'这类跨目录引用，静态页生成时工作目录可能不同；统一在生成脚本里引入并传参 - 日期、分类等需排序/过滤的逻辑，必须在生成前完成，静态页里不再执行
- 如果用了 Twig 或 Blade，得调用其
render()方法并传入数组数据，而非直接 include
URL重写规则和链接怎么保持一致
生成的HTML里所有链接（导航、分页、文章内跳转）必须和上线后的实际路径完全匹配，否则静态部署后点不开。
常见错误是写死 /post.php?id=123，正确做法是统一用函数生成目标路径：
function post_url($slug) {
return "/blog/{$slug}/"; // 对应 Nginx 的 try_files $uri $uri/ /index.html;
}
// 模板中写：<a href="<?= post_url($post['slug']) ?>"><?= $post['title'] ?></a>
- Apache 用户注意：
.htaccess里的RewriteRule和 Nginx 的try_files行为不同，生成的路径层级要跟重写规则对齐 - 如果最终部署在子目录（如
https://example.com/myblog/），所有链接开头要加/myblog/，不能只写/blog/ -
<base href="/">标签能简化相对路径，但会影响 favicon、preload 等资源加载，慎用
生成过程容易忽略的细节：编码、SEO、资源路径
生成的HTML文件看似能打开，但中文乱码、meta标签缺失、CSS不生效，往往是因为没处理底层细节。
- PHP脚本开头加
mb_internal_encoding('UTF-8');，模板文件本身也必须是UTF-8无BOM编码 - 在生成的HTML里显式写
<meta charset="UTF-8">，别依赖浏览器自动识别 - CSS/JS路径尽量用绝对路径（
/assets/css/style.css），避免相对路径在不同层级页面中解析错位 - 如果原PHP有
<title>= htmlspecialchars($title) ?></title>，静态化后仍要保留htmlspecialchars()，防止XSS残留 - Google Analytics 或评论系统（如 utterances）的JS代码可以保留，它们本来就是客户端执行的
最麻烦的其实是「增量更新」：改了一篇文章，要不要全站重建？通常只需重生成该文 + 首页 + 分类页，但判断依赖关系得靠你自己维护映射表——PHP静态化没有自动追踪机制。
