Yii页面静态化需兼顾性能与更新及时性：静态文件路径须严格匹配美化URL规则，Web服务器需配置兜底重写（如Apache的!-f/!-d判断），优先用命令行预生成保障SEO，更新时通过afterSave自动刷新文件并通知CDN。
Yii 页面静态化不是“一键生成全站 HTML”就能完事的，核心矛盾在于：既要缓存响应提升性能，又要保证内容更新及时、路径可控、不破坏路由和 SEO。硬写 file_put_contents 到 public 目录下，却没处理 URL 重写、缓存失效、多环境发布等问题，上线后反而更难维护。
静态 HTML 文件怎么生成才不踩 Apache/Nginx 重写坑
很多人把 article/104.html 写进 public/，但访问 404——不是文件没生成，是 Web 服务器根本没把请求转给 Yii。静态文件路径必须和 URL 路由规则对齐，否则 PHP 根本没机会执行。
- 确认
.htaccess（Apache）或location块（Nginx）里有兜底规则：RewriteCond %{REQUEST_FILENAME} !-f和RewriteCond %{REQUEST_FILENAME} !-d缺一不可 - 生成路径要严格匹配美化后的 URL：比如路由规则是
'article/<id:>' => 'article/view'</id:>，那静态文件就得放在public/article/104.html，不能是public/104.html或public/html/104.html - 生成前先
FileHelper::createDirectory(dirname($filePath))，避免因目录不存在导致写入失败，且错误静默 - 生产环境别用
chmod(0777)，改用 Web 服务器用户（如www-data）可写即可
什么时候该用 afterAction()，什么时候该用命令行批量生成
afterAction() 是懒加载式静态化：用户首次访问 /article/104，控制器渲染完才落地 HTML；适合低频更新、高并发读、内容生命周期长的页面（如帮助文档）。但新文章上线后没人点，静态页就永远不生成——SEO 友好性归零。
- 适合场景：
SiteController::actionPage($slug)这类数据库驱动的单页，流量稳定、更新极少 - 不适合场景：新闻列表页、搜索结果页、带用户态参数的页面（
varyByParam不起作用） - 真正要保障首屏秒开 + SEO，得走命令行预生成：
php yii article/generate-static --ids=104,105,106，配合定时任务每日凌晨跑一次 - 命令行方式必须复用 Yii 的
View::renderFile()或Controller::runAction()，确保 layout、asset bundle、i18n 全部生效，不能直接include视图文件
静态页和动态路由共存时，如何避免 404 或无限重定向
最常见错误：静态文件已存在，但用户访问 /about 仍走到 SiteController::actionPage('about')，控制器又去查数据库——这不是冗余，是逻辑冲突。关键在 Web 服务器层做优先级判断。
立即学习“前端免费学习笔记（深入）”；
- Apache：
RewriteRule ^(.*)\.html$ - [L]必须放在所有 Yii 转发规则之前，让 .html 请求直接命中文件，不进 PHP - Nginx：
location ~ \.html$ { try_files $uri =404; }要写在location /块之前，且不能被fastcgi_pass拦截 - 别依赖 Yii 的
Url::to()生成静态链接时加 .html 后缀却不配置对应路由——比如Url::to(['article/view', 'id' => 104])输出 /article/view/104，你却生成了 /article/104.html，链接和文件根本对不上 - 开发时用
curl -I http://yoursite/article/104.html看返回头：要是200 OK且Content-Type: text/html，说明静态页已生效；要是302或200但内容是 PHP 渲染结果，说明重写规则没生效
静态页内容更新了，旧 HTML 怎么自动失效
没人手动删 public/article/104.html，用户刷出来的永远是三天前的错别字。靠“等缓存过期”不现实，因为静态文件一旦生成，Web 服务器就把它当真实磁盘文件返回，压根不经过 Yii 生命周期。
- 最稳妥方案：在文章模型的
afterSave()里触发删除对应静态文件，再调用生成逻辑 —— 更新即刷新，强一致性 - 次选方案：给静态文件名加哈希后缀，如
article/104_abc123.html，URL 也同步更新；旧链接可通过 301 跳转到新地址，兼顾 SEO - 绝对别用时间戳做后缀（如
104_1745025300.html），会导致 CDN 缓存爆炸、日志分析困难 - 如果用 CDN，记得在删除/覆盖静态文件后主动调用其 Purge API，否则边缘节点可能继续吐旧内容长达数小时
静态化真正的难点不在生成，而在“何时生成、谁来触发、生成后怎么下线、失效后怎么通知 CDN”。把文件写到磁盘只是最后一步，前面每一步漏掉，都会让静态化从优化变成负优化。
