Nginx中fastcgi_cache实现PHP页面缓存加速

http {
    # 定义缓存区
    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";
    # 默认缓存时间
    fastcgi_cache_valid 200 302 10m;
    fastcgi_cache_valid 404 1m;
    # 日志格式（可选，用于调试缓存命中率）
    log_format cache_log '$remote_addr - $remote_user [$time_local] "$request" '
                         '$status $body_bytes_sent "$http_referer" '
                         'cache:$upstream_cache_status';
}

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    index index.php;

    # PHP 请求处理
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;

        # ========== 缓存核心配置 ==========
        
        # 启用缓存并指定缓存区
        fastcgi_cache PHPCACHE;
        
        # 缓存条件：仅对登录用户以外的请求缓存
        fastcgi_cache_bypass $cookie_session;      # 有 session cookie 时不读缓存
        fastcgi_no_cache $cookie_session;          # 有 session cookie 时不写缓存
        
        # 或者根据自定义 header 控制（如管理员后台不缓存）
        fastcgi_cache_bypass $http_pragma;
        fastcgi_no_cache $http_authorization;
        
        # 缓存状态头（调试用，生产环境可移除）
        add_header X-Cache-Status $upstream_cache_status;
        
        # 缓存锁定（防止缓存失效时的并发穿透）
        fastcgi_cache_lock on;
        fastcgi_cache_lock_timeout 5s;
        
        # 后台更新（旧缓存过期时，先返回旧数据，后台异步更新）
        fastcgi_cache_background_update on;
        
        # 使用 stale 缓存（后端故障时返回过期缓存）
        fastcgi_cache_use_stale error timeout invalid_header updating http_500;
    }

    # 静态文件不经过 PHP
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        expires 30d;
        access_log off;
    }
}

# 如果有 wordpress_logged_in cookie 就不缓存（WordPress 场景）
fastcgi_cache_bypass $cookie_wordpress_logged_in;
fastcgi_no_cache $cookie_wordpress_logged_in;
# 多条件组合（任一满足即不缓存）
set $skip_cache 0;
if ($cookie_session) { set $skip_cache 1; }
if ($request_method = POST) { set $skip_cache 1; }
if ($query_string != "") { set $skip_cache 1; }
if ($http_authorization) { set $skip_cache 1; }
fastcgi_cache_bypass $skip_cache;
fastcgi_no_cache $skip_cache;

location ~ /wp-admin|/wp-login|/api/ {
    fastcgi_cache off;  # 完全禁用缓存
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    include fastcgi_params;
}

location ~ \.php$ {
    fastcgi_cache PHPCACHE;
    # 首页缓存 5 分钟
    if ($request_uri = /) {
        set $cache_time 5m;
    }
    # 文章页缓存 1 小时
    if ($request_uri ~ ^/post/) {
        set $cache_time 1h;
    }
    # 默认 10 分钟
    if ($cache_time = "") {
        set $cache_time 10m;
    }
    fastcgi_cache_valid 200 $cache_time;
}

# 编译时添加 --add-module=ngx_cache_purge
location ~ /purge(/.*) {
    allow 127.0.0.1;      # 仅允许本地访问
    deny all;
    fastcgi_cache_purge PHPCACHE "$scheme$request_method$host$1";
}

#!/bin/bash
# /usr/local/bin/clear-php-cache.sh
CACHE_DIR="/var/cache/nginx/fastcgi"
TARGET="$1"
if [ -z "$TARGET" ]; then
    # 清理全部缓存
    rm -rf ${CACHE_DIR}/*
    echo "All cache cleared"
else
    # 根据 URL 计算缓存文件路径（匹配 fastcgi_cache_key）
    KEY="$scheme$request_method$host$TARGET"
    MD5=$(echo -n "$KEY" | md5sum | awk '{print $1}')
    LEVEL1=${MD5: -1}
    LEVEL2=${MD5: -3:2}
    rm -f "${CACHE_DIR}/${LEVEL1}/${LEVEL2}/${MD5}"
    echo "Cache for $TARGET cleared"
fi
# 重载 Nginx 使更改生效（或发送信号）
kill -HUP $(cat /var/run/nginx.pid)

http {
    # 缓存路径优化：SSD 建议用 levels=1:2，机械硬盘用 levels=1:2:3
    fastcgi_cache_path /var/cache/nginx/fastcgi 
        levels=1:2 
        keys_zone=PHPCACHE:256m  # 内存中存储 256MB 的键
        max_size=10g             # 磁盘最大 10GB
        inactive=7d              # 7 天未访问则清理
        use_temp_path=off        # 直接写入目标目录，减少 IO
        manager_files=10000      # 每次清理最多处理 10000 文件
        manager_sleep=50ms       # 清理间隔
        manager_threshold=200ms; # 单次清理最大耗时
    # 忽略后端设置的缓存控制头（强制按 Nginx 配置缓存）
    fastcgi_ignore_headers X-Accel-Expires Expires Cache-Control Set-Cookie;
    # 隐藏后端版本信息
    fastcgi_hide_header X-Powered-By;
    fastcgi_hide_header Server;
}
server {
    location ~ \.php$ {
        fastcgi_cache PHPCACHE;
        fastcgi_cache_valid 200 5m;
        # 微缓存（Microcache）：极短时间的缓存，应对突发流量
        fastcgi_cache_valid 200 1s;  # 1 秒内相同请求直接返回缓存
        # 缓存键增加设备类型（桌面/移动端分开缓存）
        fastcgi_cache_key "$scheme$request_method$host$request_uri$http_user_agent";
    }
}

# 查看缓存目录统计
find /var/cache/nginx/fastcgi -type f | wc -l
# 实时查看缓存状态头
curl -I http://example.com/page.php
# 检查响应头中的 X-Cache-Status: HIT / MISS / BYPASS / EXPIRED
# 分析日志统计命中率
awk '{print $NF}' /var/log/nginx/access.log | sort | uniq -c

fastcgi_cache_path /var/cache/nginx/wp levels=1:2 keys_zone=WPCACHE:150m max_size=2g inactive=48h;
server {
    set $skip_cache 0;
    # 不缓存的条件
    if ($request_method = POST) { set $skip_cache 1; }
    if ($query_string != "") { set $skip_cache 1; }
    if ($cookie_woocommerce_items_in_cart) { set $skip_cache 1; }  # WooCommerce
    if ($cookie_wordpress_logged_in) { set $skip_cache 1; }
    if ($request_uri ~* "/wp-admin/|/wp-login|/cart|/checkout|/my-account") { set $skip_cache 1; }
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_cache WPCACHE;
        fastcgi_cache_valid 200 60m;
        fastcgi_cache_bypass $skip_cache;
        fastcgi_no_cache $skip_cache;
        fastcgi_cache_lock on;
        fastcgi_cache_use_stale updating error timeout;
        add_header X-Cache-Status $upstream_cache_status;
    }
}