直接在Nginx层缓存PHP动态响应是降低后端压力、提升首字节时间最有效的手段之一,关键在于精准控制缓存对象(如伪静态页)、预定义缓存区与键值规则、严格绕过登录态等不安全请求,并通过响应头和日志验证命中状态。

直接在 Nginx 层缓存 PHP 动态响应,是降低后端压力、提升首字节时间最有效的手段之一。关键不在于“能不能缓”,而在于“缓什么、怎么缓、怎么不缓错”。
缓存区域与键值必须提前定义
缓存不是开个开关就生效的,得先划出一块“仓库”并规定“货品编号规则”:
-
在 http 块中声明缓存路径:指定磁盘位置、分区层级、内存索引区(keys_zone)大小和自动清理策略。例如:
fastcgi_cache_path /var/cache/nginx/fastcgi levels=1:2 keys_zone=phpcache:100m max_size=1g inactive=60m use_temp_path=off; -
统一缓存键生成逻辑:默认用 URI 区分内容,但需排除干扰因素。推荐写法:
fastcgi_cache_key "$scheme$request_method$host$request_uri";
若需支持带参数的 POST 查询,应由后端返回唯一签名(如X-Request-Sign),再加入 key 中,避免直接读取不可靠的$request_body。
只对安全、稳定、幂等的响应启用缓存
不是所有 PHP 输出都适合缓存。Nginx 默认只缓存 GET/HEAD,这是合理底线。如确需缓存 POST 响应,必须同时满足:
- 语义只读(比如搜索接口,不改状态)
- 请求体相同 → 响应体完全一致(幂等)
- 响应不含用户私有信息(无 Set-Cookie、无敏感 header)
- 显式忽略后端干扰头:
fastcgi_ignore_headers Cache-Control Expires Set-Cookie; - 明确设定有效期:
fastcgi_cache_valid 200 302 5m;
精准跳过不可缓存的请求
登录页、后台、含查询参数的页面、带 session cookie 的用户请求——这些必须绕过缓存。用变量控制最灵活:
- 定义跳过标识:
set $skip_cache 0; - 匹配后台路径:
if ($request_uri ~ "^/admin|/wp-admin|/zb_system") { set $skip_cache 1; } - 检测登录态:
if ($cookie_php_session) { set $skip_cache 1; }或检查自定义 token cookie - 在 location 中启用判断:
fastcgi_cache_bypass $skip_cache;<br>fastcgi_no_cache $skip_cache;
验证与调优不能只看配置是否生效
加了配置不等于缓存真在跑。要确认效果,得看真实响应头和日志:
- 在 server 或 location 中添加响应头便于调试:
add_header X-FastCGI-Cache $upstream_cache_status;,返回值为HIT/MIS/BYPASS - 配置 cache_log 格式,记录命中率:
log_format cache_log '... cache:$upstream_cache_status'; - 定期清理过期缓存:
find /var/cache/nginx/fastcgi -type f -mmin +60 -delete(配合inactive参数更稳妥) - 缓存目录权限必须为 Nginx 工作用户(如 www)可读写,否则写入失败,始终 MISS











