ThinkPHP站点静态化需绕开已废弃的buildHtml方法，改用topthink/think-html插件：安装后在provider.php注册服务，调用Html::build()指定模板路径、变量及public/开头的绝对输出路径，并确保Nginx rewrite规则与生成路径对齐，否则页面返回404。
想让ThinkPHP站点的新闻详情页、产品单页或活动页加载更快，又不想手动写渲染+写入逻辑？你得绕开已废弃的buildHtml方法，用轻量插件替代黑盒操作——它能自动处理模板路径解析、目录创建和URL映射，但前提是必须把关键路径对齐，否则生成的HTML永远404。
安装并启用静态化插件
在项目根目录执行：composer require topthink/think-html。该插件专为TP6设计，不依赖任何旧版buildHtml逻辑，也不修改核心类。
安装完成后，在app/provider.php中追加一行：think\html\HtmlServiceProvider::class,。这一步漏掉会导致后续调用Html::build()时报“Class not found”错误。
插件默认将HTML文件写入public/static/，无需额外配置即可启动，但若你已在Nginx中设置了rewrite ^/article/(\d+)\.html$规则，则必须保持此路径一致——改路径不如改Nginx规则来得安全。
立即学习“PHP免费学习笔记（深入）”；
用Html::build()生成单页静态文件
在控制器方法中直接调用：Html::build('article/detail', ['id' => 123], 'public/static/article/123.html');
第一个参数是模板路径，必须带目录层级，比如'portal/news/show'不能简写成'show'，否则fetch失败返回空字符串，生成的HTML就是纯空白页。
第二个参数是模板变量数组，和view()->fetch()完全一致；第三个参数是绝对输出路径，【必须以public/开头】，否则Web服务器无法直连访问，哪怕文件真实存在也会返回404。
这一步操作起来很简单，直接把上面那行代码复制进控制器的某个方法里，访问一次该接口就能生成对应HTML文件。
批量生成多篇文章静态页
第一步：查出所有待静态化的文章ID列表，例如：$ids = Db::name('article')->where('status', 1)->column('id');
第二步：遍历ID，逐个调用Html::build()并指定唯一文件名：foreach ($ids as $id) { Html::build('article/detail', ['id' => $id], "public/static/article/{$id}.html"); }
第三步：生成前先清空目标目录旧文件，避免磁盘被占满：array_map('unlink', glob('public/static/article/*.html'));。注意别在生产环境无差别执行，应加条件判断是否为部署脚本触发。
第四步：强制刷新CDN缓存（如有），否则用户仍看到旧版本页面。插件本身不处理CDN，这步必须人工介入或对接API。
验证静态页是否真正生效
方法一：直接在浏览器访问https://yoursite.com/static/article/123.html，能看到完整页面且无PHP报错提示。
方法二：用curl命令检查响应头：curl -I https://yoursite.com/article/123.html，如果返回中不含X-Powered-By: ThinkPHP，说明Nginx已跳过PHP-FPM直发HTML文件。
方法三：临时删掉public/static/article/123.html，再访问该URL，若返回404而非PHP渲染结果，证明rewrite规则未生效——此时要回头检查Nginx配置中try_files是否放在location ~ \.php$之前。
