tp6已移除buildhtml方法，需用view()->fetch()配合file_put_contents()手动实现静态页生成，注意模板路径、存储路径、资源绝对路径及nginx配置匹配。
TP6 里没有 buildHtml 方法了，别再找它——直接用 view()->fetch() 拼 file_put_contents() 就是最稳、最可控的生成方式。
为什么 buildHtml 报错“Call to undefined method”
这是照搬 TP3/TP5 教程最常踩的坑。TP6 官方已移除该方法，框架不再内置静态页生成逻辑。错误信息 Call to undefined method think\App::buildHtml() 或 Class 'think\BuildHtml' not found 都指向同一个事实：代码运行在 TP6 环境，但调用了已被删除的 API。
- TP6 的设计意图是把路径控制、命名规则、并发安全这些事交还给开发者，避免黑盒导致 404 或缓存错乱
- 不是不能静态化，而是必须手动组合：渲染 → 写入 → 路径对齐 → Web 服务器直出
- 中间件里调用
$response->setContent()或尝试捕获输出，大概率触发 “Header already sent” 或页面空白——因为中间件拿不到原始模板上下文，且无法安全终止渲染流程
view()->fetch() 必须传完整模板路径
模板路径写错，fetch() 返回空字符串，生成的 HTML 就是空白页。这不是权限或编码问题，是根本没找到模板。
- 正确写法：
view()->fetch('article/detail', ['id' => 123])，其中'article/detail'是模块/控制器/操作的完整路径（对应view/article/detail.html） - 错误写法：
view()->fetch('detail')或view()->fetch('index')—— 框架会去view/detail.html或view/index.html找，99% 不存在 - 如果模板在
portal模块下，路径就得是'portal/article/detail'，CLI 下尤其要注意模块上下文 - 调试时可先在浏览器访问该路由（如
/article/detail?id=123），确认能正常渲染，再套用fetch()
写入路径必须落在 public/ 下且匹配 Nginx 规则
生成的 HTML 文件若不在 Web 服务器可直连的路径下，浏览器永远 404；哪怕文件真实存在，只要路径不对，Nginx 就不会命中它。
- 推荐路径：
ROOT_PATH . 'public' . DS . 'static' . DS . 'article' . DS . '123.html'，即public/static/article/123.html - 绝对不要写进
runtime/、app/或项目根目录——这些路径浏览器无法通过 HTTP 直接访问 - Nginx 配置必须用
try_files $uri $uri/ @php;，且该location块要在~ \.php$之前；rewrite ^/article/(\d+)\.html$ /index.php?s=/article/detail/id/$1;这类强行转发规则会绕过文件存在性判断，让静态化失效 - 生成前确保目录存在：
is_dir($dir) || mkdir($dir, 0755, true)；检查public/static/是否对 Web 用户（如www-data）可写，否则file_put_contents()静默失败
模板里所有资源引用必须用绝对路径
相对路径（如 css/app.css、../images/logo.png）在离线 HTML 中会全部失效，打开就是无样式、无图片的裸文本。
- CSS/JS/图片一律用以
/开头的绝对路径：/static/css/app.css、/uploads/2026/05/banner.jpg - 别用
__STATIC__或__PUBLIC__这类模板变量——它们在静态 HTML 中只是字符串，不会被解析 - 动态内容更新后，旧 HTML 文件不会自动覆盖，必须主动
unlink()再写入，否则磁盘会被占满；高频场景建议用flock()加锁防并发写冲突 - URL 参数影响内容时，文件名必须能唯一区分，例如用
md5(request()->url(true)) . '.html'，而不是简单用id.html—— 否则/user?id=1&lang=zh和/user?id=1&lang=en会写到同一个文件里
真正难的不是“怎么生成”，而是让生成的 HTML 在浏览器地址栏敲下回车那一刻，Nginx 真的跳过了 PHP，不查数据库、不走路由、不执行任何中间件——这要求路径、权限、配置、命名四者严丝合缝，漏一不可。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
