thinkphp5静态缓存需同时开启html_cache_on并配置htmls.php规则文件才生效，缺一则完全绕过缓存逻辑；htmls.php必须置于配置目录、返回合法数组，且html_path目录需真实存在并可写。
ThinkPHP5 默认不启用静态缓存，HTML_CACHE_ON 必须显式开启，且必须配合 htmls.php 规则文件才能生效——缺一不可，否则请求完全绕过静态缓存逻辑。
为什么开了 HTML_CACHE_ON 却没生成 .html 文件
常见错误是只改了配置，但漏掉了规则定义文件。ThinkPHP5 的静态缓存不是“开个开关就自动缓所有页面”，它依赖 htmls.php 提供的映射规则来决定“哪个 URL → 生成哪个 .html 文件”。没有这个文件，哪怕 HTML_CACHE_ON 设为 true，框架也直接跳过缓存流程。
-
htmls.php必须放在配置目录下（如application/config/htmls.php或application/extra/htmls.php，取决于版本和加载方式） - 内容必须是合法 PHP 数组返回值，例如：
<?php return [ 'Index:index' => ['Index/index', 3600], '*' => ['{$_SERVER.REQUEST_URI|md5}', 1800], ];?> - 确保
HTML_PATH指向的目录真实存在、Web 进程可写（如runtime/html/），否则写入失败但无报错
HTML_CACHE_RULES 和 htmls.php 到底用哪个
TP5.0 起已弃用配置项 HTML_CACHE_RULES，统一由独立文件 htmls.php 管理规则。如果你在 config.php 里硬写 'HTML_CACHE_RULES'=>[...]，TP5.1+ 会直接忽略——它只认 htmls.php 返回的数组。
- 规则键名支持三种格式：
'Index:index'（指定控制器+方法）、'Index:'（该控制器全部方法）、'*'（全局兜底） - 规则值必须是数组，至少含两项：
['文件名模板', 缓存秒数]；第二项为-1表示永久，0表示不缓存（慎用） - 模板语法中
{:action}、{id}、{$_SERVER.REQUEST_URI|md5}都有效，但注意：变量未传入时会留空，导致文件名重复或冲突
静态缓存怎么触发和更新
静态缓存不是后台定时生成的，而是“首次访问动态页面时，输出后顺手写一份 .html 到 HTML_PATH；后续请求若缓存未过期，就直接 readfile() 并 exit”。所以它本质是“懒生成 + 命中即返”。
- 必须在控制器方法末尾调用
$this->display()（或return $this->fetch()），静态缓存钩子才挂得上 - 如果控制器里用了
exit、die、redirect或抛出异常，缓存不会生成 - 缓存过期后，下一次访问会重新执行控制器逻辑，并覆盖旧 .html 文件——无需手动清理，但要注意并发写入可能造成空白页（建议搭配
flock或改用 Nginx 的 try_files） - 开发时想强制刷新，删掉
HTML_PATH下对应文件即可；清空整个目录也安全，TP5 不依赖其完整性
最易被忽略的一点：静态缓存只作用于 display() / fetch() 渲染的 HTML 输出，对 JSON 接口、AJAX 返回、下载响应完全无效；同时，它无法自动感知模板内嵌的动态数据变化（比如时间戳、用户登录态），这类内容必须靠前端 JS 补充或禁用该页面的静态缓存。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
