- 程序插件介绍
- 展示图集
- 历史版本
THINKPHP页面静态缓存插件插件可以用于THINKPHP6.0以上的所有TP项目，按自己的需求配置接口，默认按尊云网站分类目录系统配置，解压上传即可。
一、插件功能描述
- 支持两种缓存模式：系统缓存（依赖ThinkPHP缓存驱动）、HTML文件缓存（生成静态文件，访问速度最快），适配不同更新频率的网站
- URL级缓存控制：可设置全局默认缓存时间，也可对单个/批量URL（支持通配符匹配）配置独立缓存时间，优先级高于默认值
- URL白名单功能：避免验证码、用户中心等动态页面被缓存，确保交互正常
- 多场景目录划分：自动区分主题与设备（PC/移动端），或按域名、模板划分缓存目录，适配复杂部署需求
- 智能缓存规则：仅缓存GET请求的200状态码HTML页面，过滤动态交互类请求（如POST）
二、核心配置文件：config/page_cache.php
| 配置项 | 说明 | 可选值/示例 |
|---|---|---|
| enable | 是否开启缓存功能 | true（开启）、false（关闭，默认） |
| type | 缓存存储类型 | system（系统缓存）、html（文件缓存，推荐低更新频率网站） |
| cache_dir_mode | 缓存目录划分模式 | auto（自动按主题+设备）、domain（按域名）、template（按模板） |
| default_time | 全局默认缓存时间（单位：秒） | 示例：3600（1小时） |
| white_list | 不缓存的URL列表，支持通配符 * | 示例：['/captcha', '/user/*']（验证码、用户相关页面不缓存） |
| url_times | 单个/批量URL独立缓存时间（优先级高于默认时间），支持通配符 | 示例：['/index' => 86400, '/list' => 600]（首页缓存1天，列表页缓存10分钟） |
| theme | 主题兼容项（实际值由 index/config/view.php 中 $theme 覆盖，无需手动设置） | 默认为空字符串 '' |
三、启用方式
1. 编辑 config/page_cache.php 文件，将 enable 配置改为 true：
'enable' => true,
2. 确认 app/index/middleware.php 中已注册中间件（默认已配置）：
\app\middleware\PageCache::class
四、关键注意事项
- 动态页面（如用户中心、表单提交页）需加入 white_list，避免缓存导致显示异常
- HTML缓存文件存储路径：runtime/index/html_cache/，清除时直接删除该目录下所有文件；系统缓存需通过代码 Cache::clear() 清除
- 配置修改后无需重启服务，即时生效
-
V1.0.0 2025-09-02
- THINKPHP页面静态缓存插件
