如何配置Nginx的PHP-FPM缓存?
美国、香港服务器
如何配置Nginx的PHP-FPM缓存?
11-19 来源:
1. 创建缓存目录并授权
mkdir -p /www/server/nginx/cache/fastcgi
chown www:www /www/server/nginx/cache/fastcgi
2. 在 nginx.conf 的 `http{}` 块添加缓存池(只能放在 http 层级)
fastcgi_cache_path /www/server/nginx/cache/fastcgi
levels=1:2
keys_zone=fcgi_cache:100m
max_size=10g
inactive=60m
use_temp_path=off;
参数说明:
- `levels=1:2`:二级散列目录,防止单目录文件过多拖慢 IO
- `keys_zone=fcgi_cache:100m`:内存索引区,名称 `fcgi_cache`,站点里要引用
- `max_size=10g`:缓存磁盘最大容量,满了自动清理冷门缓存
- `inactive=60m`:60 分钟无人访问自动删掉缓存
## 3. 站点配置(server 块内,location ~ .php$)
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
# 启用缓存
fastcgi_cache fcgi_cache;
# 缓存key
fastcgi_cache_key "$scheme$host$request_uri";
# 状态码缓存时长:200、302缓存30分钟
fastcgi_cache_valid 200 302 30m;
fastcgi_cache_valid 404 1m;
# 不缓存:登录、后台、带cookie、POST请求(非常关键,防止后台被缓存)
fastcgi_cache_bypass $cookie_phpsessid $cookie_wordpress_logged_in_ $request_method;
fastcgi_no_cache $cookie_phpsessid $cookie_wordpress_logged_in_ $request_method;
# 给响应头打标记,方便验证是否命中缓存
add_header X-FCGI-Cache $upstream_cache_status;
}
`X-FCGI-Cache` 返回值:
> - `HIT`:命中缓存
> - `MISS`:首次生成缓存
> - `BYPASS`:跳过缓存(后台 / 登录态)
> - `EXPIRED`:缓存过期
## 4. 增加 PURGE 清理接口(你之前需要的,单独 URL 清缓存)
在同个 server 块添加:
location ~ /purge(/.*) {
allow 127.0.0.1;
deny all;
fastcgi_cache_purge fcgi_cache "$scheme$host$1";
}
清理方式:在服务器本地访问 `curl http://127.0.0.1/purge/你的页面URI`
5. 检查配置 & 重载
nginx -t
nginx -s reload
## 6. 验证缓存是否生效
curl -I https://你的域名/xxx.php
看响应头 `X-FCGI-Cache`。
## 7. 重要避坑
1. **不要和宝塔自带 PHP 缓存同时开**,会冲突;
2. 有登录、购物车的站点,一定要保留 `fastcgi_cache_bypass` 排除登录 Cookie,不然会出现游客看到登录用户内容;
3. WordPress 额外建议:排除 `/wp-admin/`、`/wp-login.php`;
4. 缓存目录权限必须是 `www:www`,权限不对会报权限异常、缓存写不进去。
三二互联专业提供香港VPS,美国VPS主机,香港云服务器租用等业务香港美国到大陆CN2 GIA速度最快