TP6中静态页生成需用view()->fetch()配合file_put_contents()：先渲染模板为字符串，再写入public/static/下匹配伪静态规则的绝对路径HTML文件，确保路径、命名、权限及CDN刷新同步。
TP6 里没有 buildHtml 方法了，别再找它——直接用 view()->fetch() 拼接 file_put_contents() 就是最稳、最可控的生成方式。框架不是不支持静态化，而是把路径控制、命名逻辑、并发安全这些事交还给你，避免黑盒导致 404 或缓存错乱。
为什么不能用中间件做静态化输出
中间件没法安全终止渲染流程，更不能替代控制器里的主动输出控制。你看到的「页面空白」「Header already sent」或部分渲染，基本都是中间件里调用 $response->setContent() 后，框架又走了一遍默认输出逻辑导致的双输出。
-
view()->fetch()必须在控制器中调用，中间件拿不到原始模板上下文 - 中间件拿到的
$response->getContent()是最终响应体，此时 HTTP 头可能已发，写文件+替换内容极易出错 - 静态化本质是「判断→渲染→写入→exit」，这个原子操作只能在控制器入口完成
- 性能反而更差：每次请求都走完整生命周期，再提取内容，违背静态化初衷
如何用 view()->fetch() + file_put_contents() 安全生成
核心就三步：渲染模板成字符串、写入 public/ 下可被 Web 服务器直连的路径、确保资源引用是绝对路径。漏掉任意一环，生成的 HTML 打开就是 404 或样式丢失。
- 模板路径必须写全，比如
view()->fetch('article/detail', ['id' => 123])，不能只写'detail' - 输出路径建议固定为
public/static/article/123.html，和 Nginx rewrite 规则对齐（如rewrite ^/article/(\d+)\.html$ /index.php?s=/article/detail/id/$1;） - 写入前用
is_file()判断是否已存在，高频访问页可加flock()防并发覆盖 - 模板内所有 CSS/JS/图片必须用绝对路径，例如
/static/css/app.css，相对路径在离线 HTML 中会失效 - 确保
public/static/目录存在且 Web 用户（如 www-data）有写权限，否则file_put_contents()静默失败
定时更新与缓存失效怎么配合路由参数
静态文件名必须能唯一区分不同 URL 参数，否则 /user?id=1 和 /user?id=2 会共用一个文件，数据彻底错乱。别只依赖 request()->param()，它不保留原始 query string 编码细节。
立即学习“PHP免费学习笔记（深入）”；
- 推荐用完整 URL 哈希命名：
md5(request()->url(true)) . '.html'，url(true)包含协议、域名、路径和完整 query 字符串 - 更新时先
unlink()旧文件，否则磁盘会被占满；不要靠「覆盖写入」来更新，文件系统不保证原子性 - 定时任务（如 Linux Cron）调用命令行脚本批量重建时，记得在脚本开头手动加载环境：
require __DIR__ . '/vendor/autoload.php';并初始化应用实例 - 如果用了 CDN，更新 HTML 后需同步调用 CDN 刷新接口，否则用户看到的仍是旧版本
真正容易被忽略的点是 Nginx 配置顺序和路径一致性：生成的 HTML 文件必须落在 public/ 下，且 Nginx 的 try_files 必须放在所有 PHP 路由规则之前，否则请求永远进不了 index.php，也永远到不了静态文件。
