XAMPP配置Apache内容缓存 XAMPP开启mod_cache模块-php教程-PHP中文网

必须同时看到cache_module和cache_disk_module才算真正加载；执行httpd -m | findstr cache（windows）或./httpd -m | grep cache（macos/linux），缺一则缓存无效。

xampp配置apache内容缓存 xampp开启mod_cache模块

mod_cache 在 XAMPP 中默认不启用，且单独加载 mod_cache 模块不会产生任何缓存效果——必须配套启用 mod_cache_disk（或 mod_cache_socache）并正确配置路径、权限与响应头规则，否则所有请求都是 X-Cache: MISS。

别只看 httpd.conf 里有没有 LoadModule 行。XAMPP 的模块启用是分层的，很多模块虽存在但未激活。

打开命令行，进入 C:\xampp\apache\bin，执行：httpd -M | findstr cache（Windows）或 ./httpd -M | grep cache（macOS/Linux）
必须同时看到 cache_module 和 cache_disk_module —— 缺一不可；如果只看到一个，说明另一个没加载成功
常见失败点：mod_cache.so 和 mod_cache_disk.so 文件在 C:\xampp\apache\modules\ 下存在，但 httpd.conf 中对应 LoadModule 行仍被注释，或路径写成 modules/mod_cache.dll（Windows 应为 .dll，不是 .so）
启用方式：编辑 C:\xampp\apache\conf\httpd.conf，取消以下两行的注释（注意 Windows 下是 .dll）：
LoadModule cache_module modules/mod_cache.dll
LoadModule cache_disk_module modules/mod_cache_disk.dll
改完后务必运行 httpd -t 验证语法，再重启 Apache（控制面板点 Restart 不会报错细节，容易漏掉问题）

XAMPP 默认没有预建缓存目录，也不能直接用 /tmp 或系统临时路径——Windows 下不存在该路径，且 XAMPP 进程用户（通常是当前登录用户）对随意路径可能无写权限。

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

手动创建目录，例如：C:\xampp\apache\cache_disk
在 httpd.conf 或虚拟主机配置中添加：
CacheRoot "C:/xampp/apache/cache_disk"
注意：路径用正斜杠或双反斜杠，单反斜杠会引发转义错误
确保该目录对运行 Apache 的 Windows 用户有「完全控制」权限（右键 → 属性 → 安全 → 编辑 → 添加当前用户 → 勾选「完全控制」）
不要设为网络路径、OneDrive 同步目录或 NTFS 加密文件夹——mod_cache_disk 依赖本地文件原子操作，这些场景会导致缓存写入失败或损坏
首次启动后检查该目录是否生成了子目录（如 0/、1/），没生成说明 CacheRoot 未生效或权限拒绝

CacheEnable disk / 看似作用于全部路径，但在 XAMPP 典型开发场景中极易失效，尤其当你用 ProxyPass 转发到本地 Java/PHP 服务时。

它只对 Apache 直接响应的请求生效；若你配置了 ProxyPass /api/ http://localhost:8000/api/，那实际缓存路径应为 /api/，而不是后端的 /api/ 或根 /
更稳妥的做法是先测试静态资源：
CacheEnable disk /static/
然后把图片/CSS/JS 放到 C:\xampp\htdocs\static\ 下访问 http://localhost/static/test.jpg，观察响应头是否有 X-Cache: HIT
若仍 MISS，检查后端响应是否含 Set-Cookie 或 Cache-Control: private —— 默认情况下这些会直接跳过缓存，需加：
CacheIgnoreHeaders Set-Cookie
CacheIgnoreCacheControl off（慎用，仅调试阶段）
Windows 下注意路径大小写不敏感，但 mod_cache_disk 内部处理仍按字面匹配，避免混用 /Static/ 和 /static/

Apache error.log 里只有权限错误或模块加载失败信息，缓存命中/未命中不会默认记录。必须靠响应头和简单请求验证。

用 curl -I http://localhost/static/test.jpg 查看响应头，关键字段：
X-Cache: HIT from localhost 或 X-Cache: MISS
（X-Cache 是 mod_cache 自动注入的，无需额外配置）
首次访问返回 MISS，第二次相同 URL 返回 HIT，且响应时间明显下降（可用浏览器开发者工具 Network 标签页对比），说明磁盘缓存已工作
如果始终 MISS，检查是否漏了 CacheRoot、CacheEnable 路径不匹配、或后端响应头带 Vary: Cookie（需加 CacheIgnoreHeaders Vary 才能忽略）
Windows 下杀毒软件有时会锁定缓存目录，导致写入失败——临时禁用实时防护测试一次