Apache设置Expires缓存头教程

本文详细解析了在Windows下phpEnv集成环境中启用Apache Expires缓存头的完整配置流程与常见陷阱，涵盖mod_expires模块启用、主配置与.htaccess权限设置、MIME类型精确匹配、Expires指令优先级及语法规范，并重点揭示了PHP脚本中header()调用会直接覆盖Apache缓存头这一极易被忽视的关键问题；通过模块验证、分层调试和实操示例，帮助开发者系统性排查“配置看似正确却无效”的缓存失效难题，真正让静态资源缓存落地生效。

Apache 的 ExpiresActive 在 phpEnv 中默认不生效

phpEnv 是 Windows 下集成环境，其 Apache 默认禁用 mod_expires 模块，且 httpd.conf 中未启用 ExpiresActive On。直接写 .htaccess 会 500 错误或静默失效。

实操前先确认模块已加载：httpd -M | findstr expires（Windows 命令行），若无输出，说明模块未启用。

• 打开 phpEnv\Apache\conf\httpd.conf
• 取消注释这行：LoadModule expires_module modules/mod_expires.so
• 在 区块内或其后添加：ExpiresActive On
• 重启 Apache（通过 phpEnv 控制面板或命令行 httpd -k restart）

在 .htaccess 中设置 ExpiresByType 要避开 phpEnv 的路径陷阱

phpEnv 的 Apache 默认配置中，AllowOverride 通常只允许 FileInfo 类指令，但部分版本会限制 Expires 相关指令权限，导致 .htaccess 报 500 或被忽略。

推荐做法是：把缓存规则写进主配置，而非依赖 .htaccess；若必须用 .htaccess，需确保所在目录的 配置包含 AllowOverride Indexes FileInfo（不是仅 None 或 FileInfo 不含 Expires）。

• 示例有效规则（放在网站根目录 .htaccess）：

  ExpiresActive On
  ExpiresByType image/jpg "access plus 1 year"
  ExpiresByType text/css "access plus 1 month"
  ExpiresByType application/javascript "access plus 1 month"

• 注意 MIME 类型必须精确匹配服务器实际返回的 Content-Type，比如 .js 文件若被 PHP 解析，可能返回 text/html，此时 ExpiresByType application/javascript 就不生效
• 避免用模糊类型如 image/* —— Apache mod_expires 不支持通配符匹配

ExpiresDefault 和 ExpiresByType 的优先级与调试技巧

当两者共存时，ExpiresByType 优先级高于 ExpiresDefault。但 phpEnv 环境下容易因语法错误（如引号不闭合、时间单位拼错）导致整段失效，且无明确报错提示。

• 时间表达式必须用英文双引号包裹，且内部不能含多余空格："access plus 1 week" ✅，"access plus 1week" ❌（缺少空格）
• 常用单位只有：years / months / weeks / days / hours / minutes / seconds，不支持 year 或 min
• 验证是否生效：用浏览器开发者工具 → Network → 查看响应头是否有 Expires 和 Cache-Control；也可用 curl -I https://yoursite/css/style.css 直接检查
• 若看到 Cache-Control: max-age=0 覆盖了 Expires，说明 PHP 脚本或框架（如 ThinkPHP）手动设置了 header，需优先排查代码层输出

PHP 输出内容时 header() 会覆盖 Apache 的 Expires

这是最容易被忽略的一点：哪怕 Apache 配置完全正确，只要 PHP 脚本里调用了 header('Cache-Control: no-cache') 或类似语句，就会直接覆盖掉 Apache 设置的 Expires 和 Cache-Control 头。

• 检查所有入口文件（如 index.php）、框架初始化逻辑、甚至 Composer 自动加载器是否注入了缓存禁用头
• 临时排查方法：新建一个纯静态 test.php，内容仅为 ，不引入任何其他文件，再测响应头
• 如果静态 PHP 文件生效，而业务页面不生效，基本可锁定为业务代码或框架中间件主动干预了响应头

今天关于《Apache设置Expires缓存头教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于phpenv的内容请关注golang学习网公众号！