PHP页面静态化需兼顾时效性、更新成本与并发压力：用ob_start()捕获完整输出并加锁写入；按URI哈希分层存储文件；通过Nginx try_files+PHP异步重建实现过期不阻塞；调低realpath_cache_ttl等配置避免缓存误用。
PHP 页面静态化不是“生成一次就完事”，而是要平衡缓存时效性、更新成本和并发压力。直接写文件到 ./html/ 目录看似简单，但高并发下容易因文件锁、磁盘 I/O 或路径竞争导致空白页或 500 错误。
用 ob_start() 捕获输出再写入文件最稳妥
很多方案直接用 file_put_contents() 拼接 HTML，但忽略 PHP 执行中途出错（比如数据库超时）会导致静态文件内容不全。必须用输出缓冲捕获完整响应体：
- 在页面逻辑执行前调用
ob_start() - 所有业务逻辑（包括模板渲染、DB 查询）完成后，再用
ob_get_contents()获取完整 HTML - 写入前检查
ob_get_length() > 0，避免空内容覆盖旧静态页 - 写入使用
file_put_contents($path, $html, LOCK_EX)，强制加锁防止多进程同时写同一文件
静态文件路径不能硬编码，得按 URL 映射生成
用户访问 /article/123，静态文件不能存成 123.html，否则无法支持带查询参数的 URL（如 /article/123?utm_source=weibo）。正确做法是：
- 对原始请求 URI 做标准化：去除协议、域名、参数，保留路径部分
- 用
md5($_SERVER['REQUEST_URI'])或sha1(rawurldecode($_SERVER['REQUEST_URI']))生成唯一文件名 - 目录结构按哈希前两位分层，例如
./static/ab/cd/efgh...html，避免单目录文件过多影响 inode 查找性能
静态文件过期后不能等用户触发重建，得用异步更新
靠用户访问“撞上过期”再生成，高峰期会引发雪崩——多个请求同时发现文件过期，全部走 PHP 动态逻辑，瞬间打垮 DB。必须把“重建”从请求链路中剥离：
立即学习“PHP免费学习笔记（深入）”；
- 静态文件头部写入注释，如
，记录过期时间戳 - Nginx 配置
try_files $uri @dynamic;，命中不到静态文件才回源 PHP - PHP 中只判断是否存在且未过期；过期则立即返回已有静态页（哪怕略旧），同时用
fastcgi_finish_request()提前结束响应，再后台调用shell_exec("php /path/to/build.php $uri > /dev/null 2>&1 &")异步重建
opcache.revalidate_freq 和 realpath_cache_ttl 会影响静态文件读取性能
PHP 默认开启 realpath 缓存（默认 120 秒），如果静态文件被定时任务清理或热更新，PHP 可能还在用已删除文件的缓存路径，报 failed to open stream: No such file。关键配置要调低：
-
realpath_cache_ttl = 5（单位秒），避免路径缓存拖慢静态页切换 -
opcache.revalidate_freq = 0，关掉 opcode 文件时间戳校验（静态页本身不涉及 PHP 代码变更） - 若用 APCu 存储静态页元信息（如最后生成时间），注意
apcu.stat = 0关闭 stat 检查，否则每次读都触发文件系统调用
真正难的不是生成 HTML，而是让“静态”和“动态”在毫秒级响应、数据一致性、运维可维护性之间不互相撕扯。尤其要注意 Nginx 的 try_files 指令顺序、PHP 进程间文件锁粒度、以及异步重建失败后的降级兜底——这些地方一漏，流量高峰时根本来不及排查。
