静态缓存需配置缓存驱动、编写注册pagecache中间件、在路由或控制器中启用三者配合，禁用post/put/delete接口缓存，须验证缓存文件生成并建立清理机制。

静态缓存不是开个开关就能用的功能，它需要配置+中间件+合理触发三者配合，否则缓存不会生效，甚至可能引发安全或性能问题。

确认缓存驱动已启用并配置正确

静态页面缓存依赖底层缓存系统，必须先确保文件缓存（或其他驱动）已就绪：

• 检查 config/cache.php 中 'default' => 'file' 是否生效，且 'path' 指向 ./runtime/cache/（路径需可写）
• 确认 runtime/cache/ 目录存在、权限为 755 或 777（Linux），Windows 下需确保 IIS/Apache 用户有写入权
• 不要用 Redis/Memcached 替代 file 驱动来实现页面级静态缓存——它们不支持直接缓存完整 HTML 响应体

编写并注册页面缓存中间件

TP5.0.24 不内置页面缓存中间件，需手动创建：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 在 app/common/middleware/ 下新建 PageCache.php
• 核心逻辑是：根据请求路径生成唯一 key → 尝试读取缓存 → 命中则直接返回响应 → 未命中则执行后续逻辑并自动缓存响应内容
• 注意设置合理过期时间（如 60–3600 秒），避免缓存敏感操作（登录态、表单页、用户中心等）

在路由或控制器中启用缓存策略

静态缓存需明确作用范围，不能全局开启：

• 在 route/route.php 中对特定 GET 路由绑定中间件：Route::get('article/:id', 'index/article/read')->middleware('PageCache');
• 或在控制器方法顶部加注解（需开启注解支持）：/** @middleware PageCache */
• 禁止对 POST/PUT/DELETE 接口启用页面缓存，否则会导致表单重复提交或状态错乱

验证与清理机制要同步建立

缓存生效后必须能验证和可控清除：

• 访问目标页面后，检查 runtime/cache/ 下是否生成对应哈希命名的 PHP 文件（内容为序列化后的 Response 对象）
• 添加后台接口（如 /admin/clear-page-cache）调用 Cache::tag('page')->clear() 或遍历删除指定前缀缓存
• 内容更新时，主动清除关联缓存（例如文章编辑后，删掉 page_article_123 等 key）

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！