apache 使用 include 抽离全站通用缓存策略,核心是将 mod_expires 和 mod_headers 规则集中写入独立文件(如 /etc/apache2/conf-available/cache-rules.conf),再通过绝对路径 include 指令在各虚拟主机中复用,实现配置统一、避免重复、便于灰度更新;文件仅含缓存指令,不含 loadmodule,模块启用须在主配置中统一完成。

Apache 使用 Include 抽离全站通用的 Web 缓存过期策略,核心是把缓存相关配置(如 mod_expires 和 mod_headers 规则)集中写入独立文件,再通过 Include 指令在多个虚拟主机或全局上下文中复用。这样既避免重复配置,也便于统一维护和灰度更新。
准备独立缓存策略文件
创建一个专用配置文件,例如 /etc/apache2/conf-available/cache-rules.conf(路径可自定义),内容聚焦响应头控制,不包含模块加载逻辑:
- 只写缓存指令,不写
LoadModule—— 模块启用应在主配置中统一完成 - 优先使用
Cache-Control,兼顾Expires(兼容老旧客户端) - 按资源类型分层设置,静态资源长缓存、动态接口禁缓存
示例内容:
<ifmodule mod_expires.c> ExpiresActive On ExpiresByType text/css "access plus 1 year" ExpiresByType application/javascript "access plus 1 year" ExpiresByType image/jpg "access plus 1 year" ExpiresByType image/png "access plus 1 year" ExpiresByType image/webp "access plus 1 year" ExpiresByType font/woff2 "access plus 1 year" ExpiresDefault "access plus 1 week" </ifmodule><p><ifmodule mod_headers.c><filesmatch> Header set Cache-Control "public, max-age=31536000, immutable" </filesmatch><location> Header set Cache-Control "no-store, no-cache, must-revalidate, max-age=0" </location><location> Header set Cache-Control "private, no-store" </location></ifmodule></p>
在各虚拟主机中引入该配置
编辑每个站点的配置(如 /etc/apache2/sites-available/example.com.conf),在 <virtualhost></virtualhost> 块内合适位置插入 Include:
- 放在
DocumentRoot或ProxyPass配置之后,确保作用域覆盖正确 - 支持通配符,例如
Include /etc/apache2/conf-available/cache-*.conf - 路径必须为绝对路径;若用相对路径,需配合
ServerRoot解析,易出错,不推荐
片段示例:
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载,通过源码编译安装,开发者能够灵活定制模块、优化性能并精准控制安装路径,满足多样化的业务需求。
<virtualhost> ServerName example.com DocumentRoot /var/www/example <h1>其他 SSL 和代理配置...</h1> <p>Include /etc/apache2/conf-available/cache-rules.conf</p> <p><directory> Require all granted </directory></p></virtualhost>
验证与生效流程
配置不是写完就生效,需严格走校验 → 加载 → 测试三步:
- 先执行
apache2ctl configtest(Debian/Ubuntu)或httpd -t(RHEL/CentOS),确认语法无误 - 重启或重载服务:
systemctl reload apache2(推荐 reload,平滑更新) - 用
curl -I https://example.com/static/main.js检查响应头是否含Cache-Control和Expires;对/api/user则应看到no-store
进阶建议:环境差异化处理
若开发、测试、生产环境缓存策略不同,可用变量或条件包含提升灵活性:
- 利用 Apache 的
Define指令,在主配置中定义环境标识,如Define ENV prod - 在
cache-rules.conf中用<ifdefine env prod></ifdefine>包裹生产级长缓存规则 - 或拆分为
cache-prod.conf、cache-dev.conf,按需Include
注意:Apache 不支持运行时读取 shell 环境变量做条件判断,所有条件逻辑必须在配置解析阶段完成。










