在phpEnv集成的开发环境中，Apache作为常用的Web服务器，默认可能未开启磁盘缓存功能。Mod_disk_cache是Apache提供的一个标准缓存模块，它可以将服务器返回的响应内容以文件形式存储在磁盘上，当后续有相同的请求到达时，Apache可直接从磁盘读取缓存内容返回，从而减少PHP解析和数据库查询的开销，显著提升静态资源和某些动态页面的响应速度。
一、确认phpEnv中Apache已编译Mod_disk_cache
在开始配置之前，我们需要先确认phpEnv自带的Apache是否支持Mod_disk_cache模块。大部分phpEnv打包的Apache在编译时已经包含了该模块，只是没有在配置中加载。我们可以通过命令行进入phpEnv的Apache目录，执行如下命令查看静态编译模块列表：
# 进入phpEnv的Apache bin目录，具体路径根据安装位置调整 cd /path/to/phpEnv/apache/bin # 查看已编译模块 ./httpd -l | grep disk_cache
如果输出中包含mod_disk_cache.c，说明模块已静态编译进Apache；若没有输出，则可能需要检查phpEnv版本或手动添加动态模块。对于绝大多数phpEnv发行版，该模块都是可用的，我们只需在配置中启用即可。
另外，Mod_disk_cache依赖Mod_cache基础模块，因此也要确保mod_cache.c存在。这两个模块协同工作，前者负责缓存策略与存储后端管理，后者提供缓存引擎核心接口。缺少任何一个，磁盘缓存都无法正常运行。
二、修改Apache配置文件启用模块
phpEnv的Apache主配置文件通常位于phpEnv安装目录下的apache/conf/httpd.conf。我们用文本编辑器打开它，先找到模块加载区域，确认或添加以下两行指令。如果前面有井号注释，请删除注释符号：
LoadModule cache_module modules/mod_cache.so LoadModule disk_cache_module modules/mod_disk_cache.so
这两行分别加载了缓存核心模块和磁盘缓存存储模块。在phpEnv中，对应的mod_cache.so与mod_disk_cache.so文件一般已经存在于modules目录内，直接加载即可。若文件路径不同，请根据实际目录结构调整。
加载模块后，Apache在启动阶段就会初始化缓存子系统。不过此时还没有任何缓存规则，也不会生成缓存文件。下一步我们需要定义缓存存放位置以及哪些请求可以被缓存。
三、配置磁盘缓存根目录与权限
Mod_disk_cache通过CacheRoot指令指定缓存文件存放的根目录。我们需要在httpd.conf中增加缓存根路径设置，并确保Apache运行用户对该目录有读写权限。示例如下：
# 设置磁盘缓存根目录
CacheRoot "D:/phpEnv/apache/cache"
# 允许Apache进程写入该目录
<Directory "D:/phpEnv/apache/cache">
AllowOverride None
Require all granted
</Directory>
注意，在Windows版的phpEnv中路径使用正斜杠或双反斜杠均可，但建议统一用正斜杠避免转义问题。缓存目录不要放在系统盘临时目录，以免权限策略限制。创建该目录后，还需在文件系统中右键设置“ Everyone 或 Apache服务账户”可修改，否则Apache无法建立子缓存目录。
为了防止单个文件夹内文件过多导致文件系统检索变慢，Mod_disk_cache支持通过CacheDirLevels和CacheDirLength指令控制目录层级与命名长度。例如设置两级目录、每级名称两位，可大幅分散文件：
CacheDirLevels 2 CacheDirLength 2
四、启用指定路径的磁盘缓存
仅仅设置根目录不会自动缓存所有内容，必须用CacheEnable明确开启。最常见的做法是对图片、CSS、JS等静态资源启用磁盘缓存，也可对部分动态页面开启。配置如下：
# 对根目录下所有请求启用磁盘缓存 CacheEnable disk "/" # 或者只缓存静态目录 CacheEnable disk "/static/"
CacheEnable的第一个参数disk表示使用磁盘缓存存储机制，第二个参数是URL路径前缀。当请求URL以该前缀开头时，Apache会尝试缓存响应。如果只想缓存特定虚拟主机，可将指令放入对应的VirtualHost块中。
此外，通过CacheIgnoreCacheControl和CacheMaxExpire等指令，我们可以控制客户端强制刷新时的行为以及缓存最长有效期。例如设置最大过期时间为一天：
CacheMaxExpire 86400 CacheIgnoreCacheControl On
五、重启Apache并验证缓存效果
保存httpd.conf后，在phpEnv控制面板中重启Apache服务，或者命令行执行：
cd /path/to/phpEnv/apache/bin ./httpd -k restart
重启无报错后，访问网站的一个静态资源或已开启缓存的页面，然后检查CacheRoot指定的目录。若看到生成了类似_C0/_A1/...的层级文件夹和缓存数据文件，说明磁盘缓存已生效。可使用浏览器开发者工具观察响应头，若出现Age或X-Cache相关字段，也代表命中了缓存。
若目录为空，请依次排查：模块是否真正加载、CacheRoot目录权限是否放开、CacheEnable路径是否匹配请求、以及所请求的资源是否包含Set-Cookie或Cache-Control: no-store等禁止缓存的响应头。Apache默认不缓存带Cookie设置的动态响应，必要时可用CacheIgnoreHeaders调整。
六、常见问题与优化建议
在phpEnv里开启Mod_disk_cache时，开发者常遇到缓存不生成的问题，多数源于缓存目录权限不足或路径使用反斜杠未转义。Windows下建议统一用/书写Apache配置路径，并在资源管理器授予Apache服务写权限。
另一个误区是缓存了包含用户session的动态页面，导致信息泄露。生产环境应精确使用CacheEnable限定静态资源，或配合CacheDisable排除敏感路径：
CacheDisable "/admin/" CacheDisable "/user/profile/"
对于高并发场景，磁盘缓存虽比无缓存好，但频繁小文件读写也可能成为瓶颈。此时可结合内存缓存mod_mem_cache或前置CDN。在phpEnv本地开发环境中，开启Mod_disk_cache主要为了模拟生产缓存行为，方便调试缓存头与失效逻辑。
phpEnvApacheMod_disk_cache修改时间：2026-08-02 05:39:31